May 2012 - Pollen-commits - mailman.cloud.codelutin.com

r3347 - in trunk/src/site: fr/rst rst
by jcouteau＠users.chorem.org May 2, 2012

May 2, 2012

Author: jcouteau Date: 2012-05-02 12:22:54 +0200 (Wed, 02 May 2012) New Revision: 3347 Url: http://chorem.org/repositories/revision/pollen/3347 Log: refs #538: Improve install documentation - English translation Modified: trunk/src/site/fr/rst/configure.rst trunk/src/site/fr/rst/index.rst trunk/src/site/fr/rst/install.rst.vm trunk/src/site/rst/configure.rst trunk/src/site/rst/index.rst trunk/src/site/rst/install.rst.vm Modified: trunk/src/site/fr/rst/configure.rst =================================================================== --- trunk/src/site/fr/rst/configure.rst 2012-05-02 09:56:59 UTC (rev 3346) +++ trunk/src/site/fr/rst/configure.rst 2012-05-02 10:22:54 UTC (rev 3347) @@ -22,19 +22,19 @@ .. * #L% .. - Configurer Pollen ------------------ +~~~~~~~~~~~~~~~~~ -Comment configuer Pollen ------------------------- +Comment configurer Pollen ? +--------------------------- Toute la configuration de Pollen se fait via un fichier nommé **pollen.properties**. -Ce fichier peut se trouver à différents endroits sur la machine qui démarre Pollen : +Ce fichier peut se trouver à différents endroits sur la machine qui démarre +Pollen suivant le mode d'installation choisi : :: /etc/pollen.properties - ~/.config/pollen/pollen.properties repertoireOuEstLancePollen/pollen.properties A noter que si le fichier est déposé dans plusieurs endroits, alors les @@ -80,7 +80,7 @@ hibernate.connection.username=sa hibernate.connection.password= -Pour changer de type de base données, il faut modifier modidifer +Pour changer de type de base données, il faut modifier modifier les propriétés suivantes: :: @@ -89,19 +89,16 @@ hibernate.connection.driver_class=Driver de la base hibernate.connection.url=Url de connexion à la base -Voici un tableau d'utilisation pour les bases usuelles: +Voici un tableau des propriétés pour les bases usuelles: -+-------------------------+------------------------------------------+-----------------------+------------------------------------------+ -| Type de base de données | dialect | driver | url de connexion | -+=========================+==========================================+=======================+==========================================+ -| H2 | org.hibernate.dialect.H2Dialect | org.h2.Driver | jdbc:h2:file:emplacementBaseH2/pollendb | -+-------------------------+------------------------------------------+-----------------------+------------------------------------------+ -| PostgreSql | org.hibernate.dialect.PostgreSQLDialect | org.postgresql.Driver | jdbc:postgresql:pollen | -+-------------------------+------------------------------------------+-----------------------+------------------------------------------+ -| MySql | org.hibernate.dialect.MySQLDialect | com.mysql.jdbc.Driver | jdbc:mysql:pollen | -+-------------------------+------------------------------------------+-----------------------+------------------------------------------+ ++-------------------------+------------------------------------------+-----------------------------------+------------------------------------------+ +| Type de base de données | hibernate.dialect | hibernate.connection.driver_class | hibernate.connection.url | ++=========================+==========================================+===================================+==========================================+ +| H2 | org.hibernate.dialect.H2Dialect | org.h2.Driver | jdbc:h2:file:emplacementBaseH2/pollendb | ++-------------------------+------------------------------------------+-----------------------------------+------------------------------------------+ +| PostgreSql | org.hibernate.dialect.PostgreSQLDialect | org.postgresql.Driver | jdbc:postgresql:pollen | ++-------------------------+------------------------------------------+-----------------------------------+------------------------------------------+ +| MySql | org.hibernate.dialect.MySQLDialect | com.mysql.jdbc.Driver | jdbc:mysql:pollen | ++-------------------------+------------------------------------------+-----------------------------------+------------------------------------------+ -.. _page des options: ./pollen-ui-struts2/application-config-report.html -.. _page des Téléchargements: http://www.chorem.org/projects/pollen/files -.. _Tomcat: http://tomcat.apache.org/ -.. _Jetty: http://eclipse.org/jetty/ +.. _page des options: ./pollen-ui-struts2/application-config-report.html \ No newline at end of file Modified: trunk/src/site/fr/rst/index.rst =================================================================== --- trunk/src/site/fr/rst/index.rst 2012-05-02 09:56:59 UTC (rev 3346) +++ trunk/src/site/fr/rst/index.rst 2012-05-02 10:22:54 UTC (rev 3347) @@ -37,7 +37,7 @@ -------------------------------------------- - Pollen permet de créer des consultations sur des textes, dates ou images. -- Vous pouvez utiliser plusieurs `modes de dépouillement`_ +- Vous pouvez utiliser plusieurs `modes de dépouillement`_ comme le Condorcet. - Vous pouvez voter anonymement. - Vous pouvez modifier vos votes (même anonyme). - Vous pouvez recevoir des e-mails de notification et de rappel. @@ -68,7 +68,10 @@ - Vous pouvez installer Pollen sur votre propre serveur pour garder le contrôle de vos données (consultation confidentielle par exemple). -- Pollen est libre, vous pouvez le modifier, l'améliorer ou l'adapter a vos besoins. +- Pollen est libre, vous pouvez le modifier, l'améliorer ou l'adapter a vos + besoins. +- Vous pouvez nous remonter les bugs ou demandes d'améliorations et suivre le + projet sur notre forge_ . .. image:: home.png :alt: Page d'accueil de Pollen @@ -77,3 +80,4 @@ .. _instance de Pollen: http://pollen.chorem.org/pollen .. _Télécharger Pollen: http://www.chorem.org/projects/pollen/files .. _guide d'installation: ./install.html +.. _forge: http://www.chorem.org/projects/pollen Modified: trunk/src/site/fr/rst/install.rst.vm =================================================================== --- trunk/src/site/fr/rst/install.rst.vm 2012-05-02 09:56:59 UTC (rev 3346) +++ trunk/src/site/fr/rst/install.rst.vm 2012-05-02 10:22:54 UTC (rev 3347) @@ -46,7 +46,7 @@ Pour que Pollen soit pleinement opérationnel, il faut configurer deux choses : - l'adresse publique de Pollen (voir la section `Configurer l'adresse publique`_). -- la configuration d'envoie d'emails (voir la section `Configurer l'envoi d'email`_).). +- la configuration d'envoi d'emails (voir la section `Configurer l'envoi d'email`_).). Pour tout savoir sur la configuration de Pollen, reportez vous à la `page de configuration`_. @@ -59,7 +59,8 @@ Pollen. Par mesure de sécurité il est important de supprimer cet utilisateur -après avoir créer un autre compte administrateur. +après avoir créé un autre compte administrateur ou alors de modifier son mot de +passe. Installation en mode embarqué ============================= @@ -115,13 +116,12 @@ Configurer ---------- -En mode serveur, Il faut créer un fichier de configuration nommé -**pollen.properties** qui peut se trouver dans l'un des répertoires suivants : +En mode serveur, il faut créer un fichier de configuration nommé +**pollen.properties** dans le répertoire suivant : :: /etc/pollen.properties - ~/.config/pollen.properties Par défaut les données seront stoquées dans le répertoire suivant : Modified: trunk/src/site/rst/configure.rst =================================================================== --- trunk/src/site/rst/configure.rst 2012-05-02 09:56:59 UTC (rev 3346) +++ trunk/src/site/rst/configure.rst 2012-05-02 10:22:54 UTC (rev 3347) @@ -21,87 +21,79 @@ .. * along with this program. If not, see <http://www.gnu.org/licenses/>. .. * #L% .. - -Configurer Pollen ------------------ +Configure Pollen +~~~~~~~~~~~~~~~~ -Comment configuer Pollen ------------------------- +How to configure Pollen +----------------------- -Toute la configuration de Pollen se fait via un fichier nommé **pollen.properties**. +All Pollen configuration is done via a file named **pollen.properties**. -Ce fichier peut se trouver à différents endroits sur la machine qui démarre Pollen : +This file can be located in several places on the computer that starts Pollen, +depending on the installation mode: :: /etc/pollen.properties - ~/.config/pollen/pollen.properties - repertoireOuEstLancePollen/pollen.properties + directoryWherePollenIsLaunched/pollen.properties -A noter que si le fichier est déposé dans plusieurs endroits, alors les -configurations se cumulent. +Beware, if the file is in different places, the configurations are merged. -Pour plus d'information sur les options disponibles, -rendez-vous sur la `page des options`_. +More information on the available options is available on `options page`_. -Configurer l'adresse publique ------------------------------ +Configure the public address +---------------------------- -L'adresse publique de Pollen est l'adresse utilisée dans les emails générés. +Pollen public address is the one used in the generated emails. -On peut la configurer via la propriété suivante de la configuration : +You can configure it using the following configuration option: :: - siteUrl=Adresse publique de votre instance de pollen (utilisé pour générer les liens d'accès au sondage dans les emails envoyés) + siteUrl=your Pollen instance public address(used to generate links in sent emails) -Configurer l'envoi d'email --------------------------- +Configure mail sending +---------------------- -Pour que Pollen puisse envoyer des emails vous devez bien renseigner la -configuration: +So that Pollen can send emails you must fill in the following configuration: :: - email_host= Serveur smtp pour envoyer les emails - email_port= Port du serveur smtp - email_from= Adresse de l'envoyeur de mail + email_host= Smtp server address (ex: localhost, smtp.free.fr, ...) + email_port= Smtp server port (by default: 25) + email_from= Mail sender address (ex: mypolleninstance(a)me.com) -Configurer la base de données ------------------------------ +Configure database +------------------ -Pollen utilise une base de données. Par défaut Pollen utilise une base type -h2. +Pollen use a database. By default, Pollen use a H2 database. -Pour modifier la configuration de la base de données, on modifie dans le -fichier de configuration les lignes: +To modify the connection information, you can modify the following lines in +the configuration: :: hibernate.connection.username=sa hibernate.connection.password= -Pour changer de type de base données, il faut modifier modidifer -les propriétés suivantes: +To change the database you want to use, you to modify the following properties: :: - hibernate.dialect=Dialect de la base - hibernate.connection.driver_class=Driver de la base - hibernate.connection.url=Url de connexion à la base + hibernate.dialect=Database dialect + hibernate.connection.driver_class=Database driver + hibernate.connection.url=Database connection url -Voici un tableau d'utilisation pour les bases usuelles: +Here are the properties for usual databases: -+-------------------------+------------------------------------------+-----------------------+------------------------------------------+ -| Type de base de données | dialect | driver | url de connexion | -+=========================+==========================================+=======================+==========================================+ -| H2 | org.hibernate.dialect.H2Dialect | org.h2.Driver | jdbc:h2:file:emplacementBaseH2/pollendb | -+-------------------------+------------------------------------------+-----------------------+------------------------------------------+ -| PostgreSql | org.hibernate.dialect.PostgreSQLDialect | org.postgresql.Driver | jdbc:postgresql:pollen | -+-------------------------+------------------------------------------+-----------------------+------------------------------------------+ -| MySql | org.hibernate.dialect.MySQLDialect | com.mysql.jdbc.Driver | jdbc:mysql:pollen | -+-------------------------+------------------------------------------+-----------------------+------------------------------------------+ ++-------------------------+------------------------------------------+-----------------------------------+------------------------------------------+ +| Database | hibernate.dialect | hibernate.connection.driver_class | hibernate.connection.url | ++=========================+==========================================+===================================+==========================================+ +| H2 | org.hibernate.dialect.H2Dialect | org.h2.Driver | jdbc:h2:file:emplacementBaseH2/pollendb | ++-------------------------+------------------------------------------+-----------------------------------+------------------------------------------+ +| PostgreSql | org.hibernate.dialect.PostgreSQLDialect | org.postgresql.Driver | jdbc:postgresql:pollen | ++-------------------------+------------------------------------------+-----------------------------------+------------------------------------------+ +| MySql | org.hibernate.dialect.MySQLDialect | com.mysql.jdbc.Driver | jdbc:mysql:pollen | ++-------------------------+------------------------------------------+-----------------------------------+------------------------------------------+ -.. _page des options: ./pollen-ui-struts2/application-config-report.html -.. _page des Téléchargements: http://www.chorem.org/projects/pollen/files -.. _Tomcat: http://tomcat.apache.org/ -.. _Jetty: http://eclipse.org/jetty/ +.. _options page: ./pollen-ui-struts2/application-config-report.html \ No newline at end of file Modified: trunk/src/site/rst/index.rst =================================================================== --- trunk/src/site/rst/index.rst 2012-05-02 09:56:59 UTC (rev 3346) +++ trunk/src/site/rst/index.rst 2012-05-02 10:22:54 UTC (rev 3347) @@ -31,7 +31,7 @@ -------------------------- - Pollen features textual, date or image vote. -- You can use different `vote counting methods`_ +- You can use different `vote counting methods`_ such as Condorcet - You can vote anonymously. - You can change your votes (even anonymous ones). - You can receive notification and/or reminder emails. @@ -52,8 +52,8 @@ How to use Pollen? - Use our `shared instance of Pollen`_, with no install on your own computer. -- `Download Pollen`_ ans install it on our own computer following - `installation guide`_ . +- `Download Pollen`_ and install it on our own computer following + the `installation guide`_ . But also... ----------- @@ -61,6 +61,7 @@ - You can install Pollen on your own server to keep the control on your data (confidential vote for example). - Pollen is Libre so you can modify it, improve it, adapt it to your needs. +- You can report bugs, features request and follow the project on our forge_ .. image:: home.png :alt: Pollen screenshot @@ -69,3 +70,4 @@ .. _shared instance of Pollen: http://pollen.chorem.org/pollen .. _Download Pollen: http://www.chorem.org/projects/pollen/files .. _installation guide: ./install.html +.. _forge: http://www.chorem.org/projects/pollen Modified: trunk/src/site/rst/install.rst.vm =================================================================== --- trunk/src/site/rst/install.rst.vm 2012-05-02 09:56:59 UTC (rev 3346) +++ trunk/src/site/rst/install.rst.vm 2012-05-02 10:22:54 UTC (rev 3347) @@ -21,73 +21,118 @@ .. * along with this program. If not, see <http://www.gnu.org/licenses/>. .. * #L% .. - -Installation guide -================== -Web container -------------- +Install Pollen +============== -To install the application, you just need to deploy the war archive in a web -container like Tomcat_. +This page describes how to instal Pollen on your computer or server. -By default, a H2 database is created in the */tmp* directory. To modify this -behaviour, you only need to create the */etc/pollen.properties* file ( you can -put it into the directory from which you launch the application or in a -*".config/"* directory in your home directory) and to fill it with the following -properties :: +Foreword +======== - # database configuration - hibernate.show_sql=false - hibernate.dialect=org.hibernate.dialect.H2Dialect - hibernate.connection.username=username - hibernate.connection.password=password - hibernate.connection.driver_class=org.h2.Driver - hibernate.connection.url=jdbc:h2:file://tmp/pollen/pollen +Installation modes +------------------ - # transfered pictures directory - upImgDir=/tmp/pollen/uploadedImages +You have two different Pollen installation modes available : - # maximal size of transfered pictures (in bytes) - upload.filesize-max=1048576 - upload.requestsize-max=10485760 +- **Embedded mode** : in this mode Pollen is an autonomous application that can + be launched without any web container. - # automatic email sending configuration - email_host=smtp.free.fr - email_port=25 - email_from=bot(a)pollen.org +- **Server mode** : in this mode, Pollen have to be deployed in a web container + (Tomcat, Jetty,...) with a configuration adapted to a server. - # syndication flux directory (Atom) - feedDir=/tmp/pollen/feeds +Configure Pollen +---------------- - # site adresse (used for reminder emails) - siteUrl=http://www.site.org/pollen/ +So that Pollen is fully operational, you have to configure two things : -For example, for a PostgreSQL database, we will have :: +- the public Pollen address (see the `Configure the public address`_ section). +- the mail sending configuration (see the `Configure mail sending`_ section). - hibernate.dialect=org.hibernate.dialect.PostgreSQLDialect - hibernate.connection.driver_class=org.postgresql.Driver - hibernate.default_schema=public +If you want to know everything about Pollen configuration, go to the +`configuration page`_. -It may be necessary to redeploy the application after having modified this -file; +Connect to Pollen +----------------- -A user with administration rights is automatically added (login "admin", -password "pollen"). For safety measures, it is really important to delete this -user (or modify its password) after having created another administrator account. +A user with admin rights is automatically created (login **admin**, password +**pollen**) on Pollen first start. -Embedded container ------------------- +For security reasons, it is important to delete this user after creating another +admin account or change the password. -Since pollen-1.1.1, the war bundle embed a servlet container based on winstone. -To run it, just launch with following command : +Embedded mode installation +========================== +Install +------- + +- Download the **${project.build.finalName}-bin.zip** archive on the Downloads_ + page. +- Unzip the dowloaded archive. + +Configure +--------- + +In embedded mode, the configuration file **pollen.properties** is located at the +uncompressed archive root. + +All data is stored in the *data* directory. + +Start +----- + +You can start Pollen with one of those commands : + :: - java -jar pollen-x.x.x.war + ./pollen.sh (on linux) +:: -Then open a browser to address : http://localhost:8080/. + pollen.bat (on windows) -You can also use command line option to configure launch : http://winstone.sourceforge.net/#commandLine +Then, once Pollen started, a web browser should open at the following address +:: + + http://localhost:8888 + + +Server mode installation +======================== + +Install +------- + +- Download the **${project.build.finalName}.war** archive on the Downloads_ + page. +- Fill in the configuration (see the configuration_ section). + +Configure +--------- + +In server mode, you have to create a configuration file named +**pollen.properties** in the following directory : + +:: + + /etc/pollen.properties + +By default, the data will be stored in the following directory : + +:: + + /var/local/pollen/data + +Start +----- + +Deploy the war file in your web container like Tomcat_ or Jetty_. + +.. _configuration: ./configure.html +.. _Downloads: http://www.chorem.org/projects/pollen/files .. _Tomcat: http://tomcat.apache.org/ +.. _Jetty: http://eclipse.org/jetty/ +.. _Configure the public address: ./configure.html#Configure_the_public_address +.. _Configure mail sending: ./configure.html#Configure_mail_sending

1 0

r3346 - trunk
by tchemit＠users.chorem.org May 2, 2012

May 2, 2012

Author: tchemit Date: 2012-05-02 11:56:59 +0200 (Wed, 02 May 2012) New Revision: 3346 Url: http://chorem.org/repositories/revision/pollen/3346 Log: use mavenpom 3.3.1 Modified: trunk/pom.xml Modified: trunk/pom.xml =================================================================== --- trunk/pom.xml 2012-05-02 09:27:56 UTC (rev 3345) +++ trunk/pom.xml 2012-05-02 09:56:59 UTC (rev 3346) @@ -10,7 +10,7 @@ <parent> <groupId>org.nuiton</groupId> <artifactId>mavenpom4redmine</artifactId> - <version>3.3</version> + <version>3.3.1</version> </parent> <groupId>org.chorem</groupId> @@ -39,6 +39,17 @@ <developers> <developer> + <id>echatellier</id> + <name>Éric Chatellier</name> + <email>chatellier at codelutin.com</email> + <organization>CodeLutin</organization> + <organizationUrl>http://www.codelutin.com/</organizationUrl> + <timezone>+1</timezone> + <roles> + <role>developer</role> + </roles> + </developer> + <developer> <id>tchemit</id> <name>Tony Chemit</name> <email>chemit at codelutin.com</email> @@ -46,7 +57,7 @@ <organizationUrl>http://www.codelutin.com/</organizationUrl> <timezone>+1</timezone> <roles> - <role>lead project</role> + <role>lead</role> <role>developer</role> </roles> </developer> @@ -64,7 +75,7 @@ </developer> <developer> <id>fdesbois</id> - <name>Florian DESBOIS</name> + <name>Florian Desbois</name> <email>desbois at codelutin.com</email> <organization>Code Lutin</organization> <organizationUrl>http://www.codelutin.com/</organizationUrl> @@ -75,7 +86,7 @@ </developer> <developer> <id>kmorin</id> - <name>Kevin MORIN</name> + <name>Kevin Morin</name> <email>morin at codelutin.com</email> <organization>Code Lutin</organization> <organizationUrl>http://www.codelutin.com/</organizationUrl> @@ -223,7 +234,7 @@ <version>${h2Version}</version> </dependency> -  +  <dependency> <groupId>org.nuiton</groupId> @@ -564,31 +575,31 @@ </activation> <reporting> - <plugins> + <plugins> -  - <plugin> - <artifactId>maven-project-info-reports-plugin</artifactId> - <version>${projectInfoReportsPluginVersion}</version> - <reportSets> - <reportSet> - <reports> - <report>project-team</report> - <report>mailing-list</report> - <report>cim</report> - <report>issue-tracking</report> - <report>license</report> - <report>scm</report> - <report>dependency-convergence</report> - <report>dependency-management</report> - </reports> - </reportSet> - </reportSets> - </plugin> - </plugins> +  + <plugin> + <artifactId>maven-project-info-reports-plugin</artifactId> + <version>${projectInfoReportsPluginVersion}</version> + <reportSets> + <reportSet> + <reports> + <report>project-team</report> + <report>mailing-list</report> + <report>cim</report> + <report>issue-tracking</report> + <report>license</report> + <report>scm</report> + <report>dependency-convergence</report> + <report>dependency-management</report> + </reports> + </reportSet> + </reportSets> + </plugin> + </plugins> </reporting> </profile>

1 0

r3345 - in trunk: . pollen-services pollen-services/src/main/java/org/chorem/pollen/services/impl
by tchemit＠users.chorem.org May 2, 2012

May 2, 2012

Author: tchemit Date: 2012-05-02 11:27:56 +0200 (Wed, 02 May 2012) New Revision: 3345 Url: http://chorem.org/repositories/revision/pollen/3345 Log: clean poms + remove old ugly SendEmail class Removed: trunk/pollen-services/src/main/java/org/chorem/pollen/services/impl/SendMail.java Modified: trunk/pollen-services/pom.xml trunk/pom.xml Modified: trunk/pollen-services/pom.xml =================================================================== --- trunk/pollen-services/pom.xml 2012-05-02 09:27:10 UTC (rev 3344) +++ trunk/pollen-services/pom.xml 2012-05-02 09:27:56 UTC (rev 3345) @@ -75,12 +75,7 @@ <groupId>org.nuiton.i18n</groupId> <artifactId>nuiton-i18n</artifactId> </dependency> -  <dependency> - <groupId>net.sf.opencsv</groupId> - <artifactId>opencsv</artifactId> - </dependency> - <dependency> <groupId>org.nuiton.topia</groupId> <artifactId>topia-persistence</artifactId> </dependency> Deleted: trunk/pollen-services/src/main/java/org/chorem/pollen/services/impl/SendMail.java =================================================================== --- trunk/pollen-services/src/main/java/org/chorem/pollen/services/impl/SendMail.java 2012-05-02 09:27:10 UTC (rev 3344) +++ trunk/pollen-services/src/main/java/org/chorem/pollen/services/impl/SendMail.java 2012-05-02 09:27:56 UTC (rev 3345) @@ -1,316 +0,0 @@ -/* - * #%L - * Pollen :: Services - * - * $Id$ - * $HeadURL$ - * %% - * Copyright (C) 2009 - 2012 CodeLutin - * %% - * This program is free software: you can redistribute it and/or modify - * it under the terms of the GNU Affero General Public License as published by - * the Free Software Foundation, either version 3 of the License, or - * (at your option) any later version. - * - * This program is distributed in the hope that it will be useful, - * but WITHOUT ANY WARRANTY; without even the implied warranty of - * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - * GNU General Public License for more details. - * - * You should have received a copy of the GNU Affero General Public License - * along with this program. If not, see <http://www.gnu.org/licenses/>. - * #L% - */ -/* *##% Pollen - * Copyright (C) 2009 CodeLutin - * - * This program is free software: you can redistribute it and/or modify - * it under the terms of the GNU General Public License as published by - * the Free Software Foundation, either version 3 of the License, or - * (at your option) any later version. - * - * This program is distributed in the hope that it will be useful, - * but WITHOUT ANY WARRANTY; without even the implied warranty of - * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - * GNU General Public License for more details. - * - * You should have received a copy of the GNU General Public License - * along with this program. If not, see <http://www.gnu.org/licenses/>. ##%*/ - -package org.chorem.pollen.services.impl; - -import au.com.bytecode.opencsv.CSVReader; -import au.com.bytecode.opencsv.CSVWriter; -import org.apache.commons.io.FileUtils; -import org.apache.commons.io.IOUtils; -import org.chorem.pollen.PollenConfiguration; -import org.nuiton.util.FileUtil; -import org.slf4j.Logger; -import org.slf4j.LoggerFactory; - -import java.io.BufferedOutputStream; -import java.io.BufferedReader; -import java.io.File; -import java.io.FileOutputStream; -import java.io.FileReader; -import java.io.IOException; -import java.io.OutputStreamWriter; -import java.io.Reader; -import java.io.Writer; -import java.util.List; - -/** - * Note tchemit : Not used at the moment, perharps later if needed. - * - * Mass mail management class. - * - * This class store email to send in a csv file, and send it (one per second) in - * a second time. - * This class can restart to send mail at application restart. - * - * For a mass mail sending to start, following files must be present: - * <ul> - * <li>xxx.emails : CSV file ("email", "subject", "body")</li> - * <li>xxx.index : next index to manage ( inited at 0)</li> - * </ul> - * - * @author chatellier - * @version $Revision$ - * - * Last update : $Date$ - * By : $Author$ - */ -public class SendMail extends Thread { - - /** logger. */ - private static final Logger log = LoggerFactory.getLogger(SendMail.class); - - public static final String EXTENSION_MAIL = ".mail"; - - public static final String EXTENSION_INDEX = ".index"; - - protected EmailService emailService; - - /** Pollen configuration. */ - protected PollenConfiguration configuration; - - /** Mail storage directory. */ - protected File mailStorageDirectory; - - public SendMail(EmailService emailService, - PollenConfiguration configuration) { - this.emailService = emailService; - this.configuration = configuration; - - // get email directory in configuration - // create it if not exists -// File filename = configuration.getEmailDirectory(); - mailStorageDirectory = configuration.getEmailDirectory(); -// -// if (!mailStorageDirectory.exists()) { -// if (mailStorageDirectory.mkdirs()) { -// if (log.isDebugEnabled()) { -// log.debug("Email storage directory created in : " + mailStorageDirectory.getAbsolutePath()); -// } -// } -// } - } - - /* - * @see java.lang.Runnable#run() - */ - @Override - public void run() { - - // try to find existing files - while (true) { - try { - sendAllMails(); - - // bloque thread until next notify - sleep(); - } catch (Exception ex) { - if (log.isErrorEnabled()) { - log.error("Error during SendMail main loop", ex); - } - } - } - } - - protected synchronized void sleep() throws InterruptedException { - wait(); - } - - public synchronized void wakeUp() { - notifyAll(); - } - - /** - * Look for all xx.index file, and restart mail sending on - * non ending mass mail sending. - * - * After execution, delete mail and index file. - * - * @throws IOException if could not send emails - */ - protected void sendAllMails() throws IOException { - - // don't do for, allways take the first found - // a new one can be created when managing one other - List<File> indexFiles = null; - do { - - // filter is java valid : .*\\.index - indexFiles = FileUtil.find(mailStorageDirectory, ".*\\" + EXTENSION_INDEX, false); - - if (!indexFiles.isEmpty()) { - File indexFile = indexFiles.get(0); - // convert index content to int - String indexContent = FileUtils.readFileToString(indexFile, "UTF-8"); - int index = Integer.parseInt(indexContent); - - // get mail content file - File mailFile = new File(indexFile.getAbsolutePath().replaceAll(EXTENSION_INDEX + "$", EXTENSION_MAIL)); - - if (log.isDebugEnabled()) { - log.debug("Managing mail file : " + mailFile + " (from index " + indexContent + ")"); - } - - Reader indexFileReader = new BufferedReader(new FileReader(mailFile)); - CSVReader cvsReader = new CSVReader(indexFileReader); - - int currentIndex = 0; - String[] currentLine = cvsReader.readNext(); - while (currentLine != null) { - String receiver = currentLine[0]; - String subject = currentLine[1]; - String body = currentLine[2]; - - log.debug("Props = " + configuration.getProperties()); - - // index contains next index to treat so == is ok - if (currentIndex >= index) { - - EmailService.PollenEmail pollenEmail = - EmailService.createPollenEmail( - receiver, - subject, - body - ); - emailService.sendEmail(pollenEmail); - -// MailUtil.sendMail(configuration.getProperty("email_host"), -// Integer.parseInt(configuration.getProperty("email_port")), -// configuration.getProperty("email_from"), -// receiver, subject, body); - - // index contains next index to treat - FileUtils.writeStringToFile( - indexFile, - String.valueOf(currentIndex + 1)); - - // wait 2 secondes between each mail to not - // load smtp server - try { - Thread.sleep(1000); - } catch (InterruptedException ex) { - if (log.isErrorEnabled()) { - log.error("Can't wait between mail", ex); - } - } - } else { - if (log.isDebugEnabled()) { - log.debug("Mail to " + receiver + " already sent in a previous execution, skip."); - } - } - - currentIndex++; - currentLine = cvsReader.readNext(); - } - - // delete both index and mail file - mailFile.delete(); - indexFile.delete(); - } else { - if (log.isInfoEnabled()) { - log.info("No more index mail index file found, go to sleep a while :)"); - } - } - } while (!indexFiles.isEmpty()); - } - - /** - * Prepare mail list. - * - * TODO : improve configuration reading - * - * @param id - * @param mailData - * @throws IOException - */ - public void prepareMails(String id, - List<EmailService.PollenEmail> mailData) throws IOException { - - Writer fileWriter = null; - CSVWriter cvsWriter = null; - try { - - // write CSV datas - File emailFile = new File(mailStorageDirectory, id + EXTENSION_MAIL); - fileWriter = new OutputStreamWriter(new BufferedOutputStream(new FileOutputStream(emailFile))); - cvsWriter = new CSVWriter(fileWriter); - - for (EmailService.PollenEmail singleMailData : mailData) { - String[] nextLine = new String[]{ - singleMailData.getTo(), - singleMailData.getSubject(), - singleMailData.getTo() - }; - cvsWriter.writeNext(nextLine); - } - - // write index (default to 0) - File indexFile = new File(mailStorageDirectory, id + EXTENSION_INDEX); - FileUtil.writeString(indexFile, "0"); - } finally { - if (cvsWriter != null) { - cvsWriter.close(); - } - IOUtils.closeQuietly(fileWriter); - } - - } - -// public void prepareMails(String id, List<Map<String, String>> mailData) throws IOException { -// -// Writer fileWriter = null; -// CSVWriter cvsWriter = null; -// try { -// -// // write CSV datas -// File emailFile = new File(mailStorageDirectory, id + EXTENSION_MAIL); -// fileWriter = new OutputStreamWriter(new BufferedOutputStream(new FileOutputStream(emailFile))); -// cvsWriter = new CSVWriter(fileWriter); -// -// for (Map<String, String> singleMailData : mailData) { -// String[] nextLine = new String[] { -// singleMailData.get("receiver"), -// singleMailData.get("subject"), -// singleMailData.get("body") -// }; -// cvsWriter.writeNext(nextLine); -// } -// -// // write index (default to 0) -// File indexFile = new File(mailStorageDirectory, id + EXTENSION_INDEX); -// FileUtil.writeString(indexFile, "0"); -// } -// finally { -// if (cvsWriter != null) { -// cvsWriter.close(); -// } -// IOUtils.closeSilently(fileWriter); -// } -// -// } -} Modified: trunk/pom.xml =================================================================== --- trunk/pom.xml 2012-05-02 09:27:10 UTC (rev 3344) +++ trunk/pom.xml 2012-05-02 09:27:56 UTC (rev 3345) @@ -22,42 +22,209 @@ <module>pollen-persistence</module> <module>pollen-services</module> <module>pollen-ui-struts2</module> -  -  </modules> + <name>Pollen</name> + <description>Application de vote Pollen</description> + <inceptionYear>2009</inceptionYear> + <url>http://maven-site.chorem.org/pollen</url> + + <licenses> + <license> + <name>GNU Affero General Public License version 3</name> + <url>http://www.gnu.org/licenses/agpl.txt</url> + <distribution>repo</distribution> + </license> + </licenses> + + <developers> + <developer> + <id>tchemit</id> + <name>Tony Chemit</name> + <email>chemit at codelutin.com</email> + <organization>Code Lutin</organization> + <organizationUrl>http://www.codelutin.com/</organizationUrl> + <timezone>+1</timezone> + <roles> + <role>lead project</role> + <role>developer</role> + </roles> + </developer> + <developer> + <id>jcouteau</id> + <name>Jean Couteau</name> + <email>couteau at codelutin.com</email> + <organization>Code Lutin</organization> + <organizationUrl>http://www.codelutin.com/</organizationUrl> + <timezone>+1</timezone> + <roles> + <role>developer</role> + <role>technical writer</role> + </roles> + </developer> + <developer> + <id>fdesbois</id> + <name>Florian DESBOIS</name> + <email>desbois at codelutin.com</email> + <organization>Code Lutin</organization> + <organizationUrl>http://www.codelutin.com/</organizationUrl> + <timezone>+1</timezone> + <roles> + <role>developer</role> + </roles> + </developer> + <developer> + <id>kmorin</id> + <name>Kevin MORIN</name> + <email>morin at codelutin.com</email> + <organization>Code Lutin</organization> + <organizationUrl>http://www.codelutin.com/</organizationUrl> + <timezone>+1</timezone> + <roles> + <role>developer</role> + </roles> + </developer> + </developers> + + <contributors> + <contributor> + <name>Erwan NEMA</name> + <email>nemawan(a)hotmail.com</email> + <organization>ALMA - Code Lutin</organization> + <organizationUrl>http:/alma.univ-nantes.fr</organizationUrl> + <timezone>+1</timezone> + <roles> + <role>Chef de Projet</role> + <role>Analyste</role> + <role>Développeur</role> + </roles> + </contributor> + <contributor> + <name>Thierry POULIT-POUBLAT</name> + <email>tpoulit(a)gmail.com</email> + <organization>ALMA - Code Lutin</organization> + <organizationUrl>http:/alma.univ-nantes.fr</organizationUrl> + <timezone>+1</timezone> + <roles> + <role>Analyste</role> + <role>Développeur</role> + </roles> + </contributor> + <contributor> + <name>Abdelmajid BOUKHARY</name> + <email>benouna66(a)gmail.com</email> + <organization>ALMA - Code Lutin</organization> + <organizationUrl>http:/alma.univ-nantes.fr</organizationUrl> + <timezone>+1</timezone> + <roles> + <role>Analyste</role> + <role>Développeur</role> + </roles> + </contributor> + <contributor> + <name>Thomas CICOGNANI</name> + <email>zhykos(a)gmail.com</email> + <organization>ALMA - Code Lutin</organization> + <organizationUrl>http:/alma.univ-nantes.fr</organizationUrl> + <timezone>+1</timezone> + <roles> + <role>Architecte</role> + <role>Développeur</role> + </roles> + </contributor> + <contributor> + <name>Amine EDDAHBI</name> + <email>eddahbi(a)gmail.com</email> + <organization>ALMA - Code Lutin</organization> + <organizationUrl>http:/alma.univ-nantes.fr</organizationUrl> + <timezone>+1</timezone> + <roles> + <role>Architecte</role> + <role>Développeur</role> + </roles> + </contributor> + <contributor> + <name>Nolwenn RANNOU</name> + <email>rannou at codelutin.com</email> + <organization>Code Lutin</organization> + <organizationUrl>http://www.codelutin.com/</organizationUrl> + <timezone>+1</timezone> + <roles> + <role>Concepteur</role> + <role>Développeur</role> + </roles> + </contributor> + </contributors> + + <packaging>pom</packaging> + + <properties> + +  + <platform>chorem.org</platform> + <projectId>pollen</projectId> + +  + <topiaVersion>2.6.9</topiaVersion> + <eugenePluginVersion>2.4.2</eugenePluginVersion> + <nuitonI18nVersion>2.4.1</nuitonI18nVersion> + + <nuitonWebVersion>1.11</nuitonWebVersion> + <nuitonUtilsVersion>2.4.8-SNAPSHOT</nuitonUtilsVersion> + <h2Version>1.3.166</h2Version> + <postgresqlVersion>9.1-901-1.jdbc4</postgresqlVersion> + <struts2Version>2.3.1.2</struts2Version> + <jqueryPluginVersion>3.3.0</jqueryPluginVersion> + <shiroVersion>1.2.0</shiroVersion> + <slf4jVersion>1.6.4</slf4jVersion> + <jettyVersion>${jettyPluginVersion}</jettyVersion> + +  + <license.licenseName>agpl_v3</license.licenseName> + +  + <locales>en,fr</locales> + <scmwebeditorEnabled>true</scmwebeditorEnabled> + + </properties> + <dependencyManagement> <dependencies> +  + <dependency> + <groupId>org.nuiton.topia</groupId> + <artifactId>topia-persistence</artifactId> + <version>${topiaVersion}</version> + </dependency> + + <dependency> + <groupId>org.nuiton.topia</groupId> + <artifactId>topia-service-migration</artifactId> + <version>${topiaVersion}</version> + </dependency> + + <dependency> <groupId>org.hibernate</groupId> <artifactId>hibernate-core</artifactId> <version>3.6.10.Final</version> </dependency> -  - <dependency> - <groupId>org.apache.commons</groupId> - <artifactId>commons-email</artifactId> - <version>1.2</version> + <groupId>postgresql</groupId> + <artifactId>postgresql</artifactId> + <version>${postgresqlVersion}</version> </dependency> - <dependency> - <groupId>commons-fileupload</groupId> - <artifactId>commons-fileupload</artifactId> - <version>1.2.2</version> - </dependency> <dependency> - <groupId>javax.mail</groupId> - <artifactId>mail</artifactId> - <version>1.4.5</version> + <groupId>com.h2database</groupId> + <artifactId>h2</artifactId> + <version>${h2Version}</version> </dependency> +  + <dependency> <groupId>org.nuiton</groupId> <artifactId>nuiton-utils</artifactId> @@ -91,66 +258,14 @@ </dependency> <dependency> - <groupId>org.nuiton.web</groupId> - <artifactId>nuiton-tapestry</artifactId> - <version>${nuitonWebVersion}</version> - </dependency> - - <dependency> <groupId>org.nuiton.i18n</groupId> <artifactId>nuiton-i18n</artifactId> <version>${nuitonI18nVersion}</version> </dependency> - <dependency> - <groupId>org.nuiton.topia</groupId> - <artifactId>topia-persistence</artifactId> - <version>${topiaVersion}</version> - </dependency> +  <dependency> - <groupId>org.nuiton.topia</groupId> - <artifactId>topia-service-migration</artifactId> - <version>${topiaVersion}</version> - </dependency> - - <dependency> - <groupId>org.apache.tapestry</groupId> - <artifactId>tapestry-core</artifactId> - <version>${tapestryVersion}</version> - <scope>compile</scope> - <exclusions> - <exclusion> - <groupId>jboss</groupId> - <artifactId>javassist</artifactId> - </exclusion> - </exclusions> - </dependency> - <dependency> - <groupId>org.apache.tapestry</groupId> - <artifactId>tapestry5-annotations</artifactId> - <version>${tapestryVersion}</version> - </dependency> - <dependency> - <groupId>org.apache.tapestry</groupId> - <artifactId>tapestry-ioc</artifactId> - <version>${tapestryVersion}</version> - </dependency> - - <dependency> - <groupId>org.slf4j</groupId> - <artifactId>slf4j-api</artifactId> - <version>${slf4jVersion}</version> - <scope>compile</scope> - </dependency> - <dependency> - <groupId>org.slf4j</groupId> - <artifactId>slf4j-log4j12</artifactId> - <version>${slf4jVersion}</version> - <scope>runtime</scope> - </dependency> - - <dependency> <groupId>org.apache.shiro</groupId> <artifactId>shiro-core</artifactId> <version>${shiroVersion}</version> @@ -161,25 +276,34 @@ <version>${shiroVersion}</version> </dependency> +  -  <dependency> - <groupId>org.apache.tapestry</groupId> - <artifactId>tapestry-upload</artifactId> - <version>${tapestryVersion}</version> + <groupId>org.jfree</groupId> + <artifactId>jfreechart</artifactId> + <version>1.0.14</version> </dependency> + <dependency> - <groupId>org.chenillekit</groupId> - <artifactId>chenillekit-tapestry</artifactId> - <version>1.0.0</version> - <exclusions> - <exclusion> - <groupId>jboss</groupId> - <artifactId>javassist</artifactId> - </exclusion> - </exclusions> + <groupId>org.jfree</groupId> + <artifactId>jcommon</artifactId> + <version>1.0.17</version> </dependency> + <dependency> + <groupId>javassist</groupId> + <artifactId>javassist</artifactId> + <version>3.12.1.GA</version> + </dependency> + +  + + <dependency> + <groupId>rome</groupId> + <artifactId>rome</artifactId> + <version>1.0</version> + </dependency> +  <dependency> @@ -230,49 +354,27 @@ </exclusions> </dependency> +  + <dependency> - <groupId>org.jdom</groupId> - <artifactId>jdom</artifactId> - <version>1.1.3</version> + <groupId>org.slf4j</groupId> + <artifactId>slf4j-api</artifactId> + <version>${slf4jVersion}</version> + <scope>compile</scope> </dependency> <dependency> - <groupId>org.jfree</groupId> - <artifactId>jfreechart</artifactId> - <version>1.0.14</version> + <groupId>org.slf4j</groupId> + <artifactId>slf4j-log4j12</artifactId> + <version>${slf4jVersion}</version> + <scope>runtime</scope> </dependency> - <dependency> - <groupId>org.jfree</groupId> - <artifactId>jcommon</artifactId> - <version>1.0.17</version> - </dependency> - <dependency> - <groupId>javassist</groupId> - <artifactId>javassist</artifactId> - <version>3.12.1.GA</version> - </dependency> - <dependency> - <groupId>net.sf.opencsv</groupId> - <artifactId>opencsv</artifactId> - <version>2.3</version> - </dependency> - <dependency> - <groupId>rome</groupId> - <artifactId>rome</artifactId> - <version>1.0</version> - </dependency> -  - <dependency> - <groupId>postgresql</groupId> - <artifactId>postgresql</artifactId> - <version>${postgresqlVersion}</version> - </dependency> +  -  <dependency> - <groupId>com.h2database</groupId> - <artifactId>h2</artifactId> - <version>${h2Version}</version> + <groupId>javax.mail</groupId> + <artifactId>mail</artifactId> + <version>1.4.5</version> </dependency> <dependency> @@ -281,200 +383,29 @@ <version>2.5</version> <scope>provided</scope> </dependency> + <dependency> <groupId>org.mortbay.jetty</groupId> <artifactId>jetty-runner</artifactId> <version>${jettyVersion}</version> <scope>provided</scope> </dependency> + <dependency> <groupId>javax.activation</groupId> <artifactId>activation</artifactId> <version>1.1.1</version> </dependency> - <dependency> - <groupId>org.jvnet.hudson.winstone</groupId> - <artifactId>winstone</artifactId> - <version>0.9.10-hudson-24</version> - </dependency> - <dependency> - <groupId>jfree</groupId> - <artifactId>jfreechart</artifactId> - <version>1.0.12</version> + <groupId>org.jdom</groupId> + <artifactId>jdom</artifactId> + <version>1.1.3</version> </dependency> </dependencies> </dependencyManagement> -  -  -  - - <name>Pollen</name> - <description>Application de vote Pollen</description> - <inceptionYear>2009</inceptionYear> - <url>http://maven-site.chorem.org/pollen</url> - - <licenses> - <license> - <name>GNU Affero General Public License version 3</name> - <url>http://www.gnu.org/licenses/agpl.txt</url> - <distribution>repo</distribution> - </license> - </licenses> - -  - <developers> - <developer> - <id>fdesbois</id> - <name>Florian DESBOIS</name> - <email>florian.desbois(a)gmail.com</email> - <organization>ALMA - Code Lutin</organization> - <organizationUrl>http:/alma.univ-nantes.fr</organizationUrl> - <timezone>+1</timezone> - <roles> - <role>Chef de Projet</role> - <role>Analyste</role> - <role>Développeur</role> - </roles> - </developer> - <developer> - <id>enema</id> - <name>Erwan NEMA</name> - <email>nemawan(a)hotmail.com</email> - <organization>ALMA - Code Lutin</organization> - <organizationUrl>http:/alma.univ-nantes.fr</organizationUrl> - <timezone>+1</timezone> - <roles> - <role>Chef de Projet</role> - <role>Analyste</role> - <role>Développeur</role> - </roles> - </developer> - <developer> - <id>kmorin</id> - <name>Kevin MORIN</name> - <email>km(a)kevinmorin.net</email> - <organization>ALMA - Code Lutin</organization> - <organizationUrl>http:/alma.univ-nantes.fr</organizationUrl> - <timezone>+1</timezone> - <roles> - <role>Architecte</role> - <role>Développeur</role> - </roles> - </developer> - <developer> - <id>tpoulit</id> - <name>Thierry POULIT-POUBLAT</name> - <email>tpoulit(a)gmail.com</email> - <organization>ALMA - Code Lutin</organization> - <organizationUrl>http:/alma.univ-nantes.fr</organizationUrl> - <timezone>+1</timezone> - <roles> - <role>Analyste</role> - <role>Développeur</role> - </roles> - </developer> - <developer> - <id>aboukhary</id> - <name>Abdelmajid BOUKHARY</name> - <email>benouna66(a)gmail.com</email> - <organization>ALMA - Code Lutin</organization> - <organizationUrl>http:/alma.univ-nantes.fr</organizationUrl> - <timezone>+1</timezone> - <roles> - <role>Analyste</role> - <role>Développeur</role> - </roles> - </developer> - <developer> - <id>tcicognagni</id> - <name>Thomas CICOGNANI</name> - <email>zhykos(a)gmail.com</email> - <organization>ALMA - Code Lutin</organization> - <organizationUrl>http:/alma.univ-nantes.fr</organizationUrl> - <timezone>+1</timezone> - <roles> - <role>Architecte</role> - <role>Développeur</role> - </roles> - </developer> - <developer> - <id>aeddahbi</id> - <name>Amine EDDAHBI</name> - <email>eddahbi(a)gmail.com</email> - <organization>ALMA - Code Lutin</organization> - <organizationUrl>http:/alma.univ-nantes.fr</organizationUrl> - <timezone>+1</timezone> - <roles> - <role>Architecte</role> - <role>Développeur</role> - </roles> - </developer> - <developer> - <id>nrannou</id> - <name>Nolwenn RANNOU</name> - <email>rannou(a)codelutin.com</email> - <organization>Code Lutin</organization> - <organizationUrl>http://www.codelutin.com/</organizationUrl> - <timezone>+1</timezone> - <roles> - <role>Concepteur</role> - <role>Développeur</role> - </roles> - </developer> - <developer> - <id>tchemit</id> - <name>Tony Chemit</name> - <email>chemit(a)codelutin.com</email> - <organization>CodeLutin</organization> - <timezone>+2</timezone> - <roles> - <role>Développeur</role> - </roles> - </developer> - </developers> - -  -  -  - - <packaging>pom</packaging> - - - <properties> - -  - <platform>chorem.org</platform> - <projectId>pollen</projectId> - -  - <topiaVersion>2.6.9</topiaVersion> - <eugenePluginVersion>2.4.2</eugenePluginVersion> - <nuitonI18nVersion>2.4.1</nuitonI18nVersion> - <tapestryVersion>5.1.0.5</tapestryVersion> - <nuitonWebVersion>1.11</nuitonWebVersion> - <nuitonUtilsVersion>2.4.8-SNAPSHOT</nuitonUtilsVersion> - <h2Version>1.3.166</h2Version> - <postgresqlVersion>9.1-901-1.jdbc4</postgresqlVersion> - <struts2Version>2.3.1.2</struts2Version> - <jqueryPluginVersion>3.3.0</jqueryPluginVersion> - <shiroVersion>1.2.0</shiroVersion> - <slf4jVersion>1.6.4</slf4jVersion> - <jettyVersion>${jettyPluginVersion}</jettyVersion> - -  - <license.licenseName>agpl_v3</license.licenseName> - -  - - <locales>en,fr</locales> - <scmwebeditorEnabled>true</scmwebeditorEnabled> - - </properties> - <build> <pluginManagement> @@ -508,6 +439,7 @@ </dependency> </dependencies> </plugin> + <plugin> <groupId>org.nuiton.i18n</groupId> <artifactId>maven-i18n-plugin</artifactId> @@ -623,14 +555,44 @@ <profiles> <profile> - <id>extra-modulesA</id> + <id>reporting</id> + <activation> + <property> + <name>performRelease</name> + <value>true</value> + </property> + </activation> - <modules> - <module>pollen-domain</module> - <module>pollen-business</module> - <module>pollen-ui</module> - </modules> + <reporting> + <plugins> + +  + <plugin> + <artifactId>maven-project-info-reports-plugin</artifactId> + <version>${projectInfoReportsPluginVersion}</version> + <reportSets> + <reportSet> + <reports> + <report>project-team</report> + <report>mailing-list</report> + <report>cim</report> + <report>issue-tracking</report> + <report>license</report> + <report>scm</report> + <report>dependency-convergence</report> + <report>dependency-management</report> + </reports> + </reportSet> + </reportSets> + </plugin> + </plugins> + </reporting> + </profile> + </profiles> </project>

1 0

r3344 - trunk
by tchemit＠users.chorem.org May 2, 2012

May 2, 2012

Author: tchemit Date: 2012-05-02 11:27:10 +0200 (Wed, 02 May 2012) New Revision: 3344 Url: http://chorem.org/repositories/revision/pollen/3344 Log: fixes #510: Remove old modules Removed: trunk/pollen-business/ trunk/pollen-ui/

1 0

r3343 - trunk
by jcouteau＠users.chorem.org May 2, 2012

May 2, 2012

Author: jcouteau Date: 2012-05-02 11:03:02 +0200 (Wed, 02 May 2012) New Revision: 3343 Url: http://chorem.org/repositories/revision/pollen/3343 Log: Licence url Modified: trunk/pom.xml Modified: trunk/pom.xml =================================================================== --- trunk/pom.xml 2012-05-02 08:43:18 UTC (rev 3342) +++ trunk/pom.xml 2012-05-02 09:03:02 UTC (rev 3343) @@ -320,7 +320,7 @@ <licenses> <license> <name>GNU Affero General Public License version 3</name> - <url>http://www.gnu.org/licenses/agpl.html</url> + <url>http://www.gnu.org/licenses/agpl.txt</url> <distribution>repo</distribution> </license> </licenses>

1 0

r3342 - trunk/pollen-ui-struts2/src/main/webapp/img
by fdesbois＠users.chorem.org May 2, 2012

May 2, 2012

Author: fdesbois Date: 2012-05-02 10:43:18 +0200 (Wed, 02 May 2012) New Revision: 3342 Url: http://chorem.org/repositories/revision/pollen/3342 Log: fixes #544 : missing icon Added: trunk/pollen-ui-struts2/src/main/webapp/img/moderate.png Added: trunk/pollen-ui-struts2/src/main/webapp/img/moderate.png =================================================================== (Binary files differ) Property changes on: trunk/pollen-ui-struts2/src/main/webapp/img/moderate.png ___________________________________________________________________ Added: svn:mime-type + image/png Added: svn:keywords + Author Date Id Revision HeadURL

1 0

r3341 - in trunk: pollen-persistence/src/main/java/org/chorem/pollen pollen-persistence/src/main/resources/META-INF/services pollen-persistence/src/main/resources/i18n src/site src/site/fr/rst src/site/rst
by tchemit＠users.chorem.org May 2, 2012

May 2, 2012

Author: tchemit Date: 2012-05-02 10:24:42 +0200 (Wed, 02 May 2012) New Revision: 3341 Url: http://chorem.org/repositories/revision/pollen/3341 Log: refs #538: Improve install documentation Added: trunk/src/site/fr/rst/configure.rst trunk/src/site/rst/configure.rst trunk/src/site/rst/install.rst.vm Removed: trunk/src/site/rst/install.rst Modified: trunk/pollen-persistence/src/main/java/org/chorem/pollen/PollenApplicationConfigProvider.java trunk/pollen-persistence/src/main/resources/META-INF/services/org.nuiton.util.ApplicationConfigProvider trunk/pollen-persistence/src/main/resources/i18n/pollen-persistence_en_GB.properties trunk/pollen-persistence/src/main/resources/i18n/pollen-persistence_fr_FR.properties trunk/src/site/fr/rst/index.rst trunk/src/site/fr/rst/install.rst.vm trunk/src/site/rst/index.rst trunk/src/site/site_en.xml trunk/src/site/site_fr.xml Modified: trunk/pollen-persistence/src/main/java/org/chorem/pollen/PollenApplicationConfigProvider.java =================================================================== --- trunk/pollen-persistence/src/main/java/org/chorem/pollen/PollenApplicationConfigProvider.java 2012-05-01 18:08:12 UTC (rev 3340) +++ trunk/pollen-persistence/src/main/java/org/chorem/pollen/PollenApplicationConfigProvider.java 2012-05-02 08:24:42 UTC (rev 3341) @@ -1,3 +1,26 @@ +/* + * #%L + * Pollen :: Persistence + * + * $Id$ + * $HeadURL$ + * %% + * Copyright (C) 2009 - 2012 CodeLutin + * %% + * This program is free software: you can redistribute it and/or modify + * it under the terms of the GNU Affero General Public License as published by + * the Free Software Foundation, either version 3 of the License, or + * (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * + * You should have received a copy of the GNU Affero General Public License + * along with this program. If not, see <http://www.gnu.org/licenses/>. + * #L% + */ package org.chorem.pollen; import org.nuiton.util.ApplicationConfig; Property changes on: trunk/pollen-persistence/src/main/java/org/chorem/pollen/PollenApplicationConfigProvider.java ___________________________________________________________________ Added: svn:keywords + Author Date Id Revision HeadURL Added: svn:eol-style + native Property changes on: trunk/pollen-persistence/src/main/resources/META-INF/services/org.nuiton.util.ApplicationConfigProvider ___________________________________________________________________ Added: svn:keywords + Author Date Id Revision HeadURL Added: svn:eol-style + native Modified: trunk/pollen-persistence/src/main/resources/i18n/pollen-persistence_en_GB.properties =================================================================== --- trunk/pollen-persistence/src/main/resources/i18n/pollen-persistence_en_GB.properties 2012-05-01 18:08:12 UTC (rev 3340) +++ trunk/pollen-persistence/src/main/resources/i18n/pollen-persistence_en_GB.properties 2012-05-02 08:24:42 UTC (rev 3341) @@ -1,4 +1,22 @@ +Version\ de\ l'application= pollen.application.config=Pollen configuration +pollen.configuration.adminEmail=email for default admin +pollen.configuration.charset=Charset of Pollen +pollen.configuration.contactEmail=email for contact link +pollen.configuration.dataDirectory=Directory where to put pollen data +pollen.configuration.db.login=login for default admin +pollen.configuration.db.password=password for default admin +pollen.configuration.defaultChoiceType=Default choice type to use at a new poll creation +pollen.configuration.defaultPollType=Default poll type to use at a new poll creation +pollen.configuration.defaultVoteCountingType=Default vote counting type to use at a new poll creation +pollen.configuration.emaiDirectory=directory to store emails before sending them +pollen.configuration.emailFrom=from for email sending configuration +pollen.configuration.emailHost=host for email sending configuration +pollen.configuration.emailPort=port for email sending configuration +pollen.configuration.feedDirectory=path for feed directory +pollen.configuration.imageDirectory=path for uploaded images directory +pollen.configuration.nbVoteByPage=nb votes to display per page +pollen.configuration.siteUrl=Application url pollen.exception.favorite_list_name_exist= pollen.exception.participant_doubloons= pollen.exception.participant_exist= @@ -12,20 +30,3 @@ pollen.exception.user_wrong_password= pollen.exception.vote_doubloon= pollen.exception.vote_not_allowed= -pollen.configuration.siteUrl=Application url -pollen.configuration.dataDirectory=Directory where to put pollen data -pollen.configuration.defaultChoiceType=Default choice type to use at a new poll creation -pollen.configuration.defaultVoteCountingType=Default vote counting type to use at a new poll creation -pollen.configuration.defaultPollType=Default poll type to use at a new poll creation -pollen.configuration.charset=Charset of Pollen -pollen.configuration.nbVoteByPage=nb votes to display per page -pollen.configuration.imageDirectory=path for uploaded images directory -pollen.configuration.db.login=login for default admin -pollen.configuration.db.password=password for default admin -pollen.configuration.adminEmail=email for default admin -pollen.configuration.contactEmail=email for contact link -pollen.configuration.emailHost=host for email sending configuration -pollen.configuration.emailPort=port for email sending configuration -pollen.configuration.emailFrom=from for email sending configuration -pollen.configuration.emaiDirectory=directory to store emails before sending them -pollen.configuration.feedDirectory=path for feed directory Modified: trunk/pollen-persistence/src/main/resources/i18n/pollen-persistence_fr_FR.properties =================================================================== --- trunk/pollen-persistence/src/main/resources/i18n/pollen-persistence_fr_FR.properties 2012-05-01 18:08:12 UTC (rev 3340) +++ trunk/pollen-persistence/src/main/resources/i18n/pollen-persistence_fr_FR.properties 2012-05-02 08:24:42 UTC (rev 3341) @@ -1,4 +1,22 @@ +Version\ de\ l'application= pollen.application.config=Configuration de Pollen +pollen.configuration.adminEmail=Email de l'utilisateur par défaut (Utilisateur crée lors du premier lancement de pollen) +pollen.configuration.charset=Encodnig de Pollen +pollen.configuration.contactEmail=Email pour le lien Contact +pollen.configuration.dataDirectory=Répertoire des données de Pollen +pollen.configuration.db.login=Login de l'utilisateur par défaut (Utilisateur crée lors du premier lancement de pollen) +pollen.configuration.db.password=Mot de passe de l'utilisateur par défaut (Utilisateur crée lors du premier lancement de pollen) +pollen.configuration.defaultChoiceType=Choix par défaut utilisation lors de la création d'un sondage +pollen.configuration.defaultPollType=Type de sondage lors de la création d'un sondage +pollen.configuration.defaultVoteCountingType=Type de dépouillement lors de la création d'un sondage +pollen.configuration.emaiDirectory=Répertoire des emails +pollen.configuration.emailFrom=Email de l'envoyeur dans les emails +pollen.configuration.emailHost=Serveur d'envoie d'email +pollen.configuration.emailPort=Port du serveur d'envoi d'email +pollen.configuration.feedDirectory=Répertoire des flux rss +pollen.configuration.imageDirectory=répertoire où sont enregistrés les images +pollen.configuration.nbVoteByPage=Nombre de votes à afficher par page +pollen.configuration.siteUrl=Url publique de l'aplication (utilisée dans les emails envoyés) pollen.exception.favorite_list_name_exist=La liste %1$s existe déjà pour l'utilisateur %2$s pollen.exception.participant_doubloons=Les doublons de la liste %1$s ont été ignorés \: %2$s pollen.exception.participant_exist=La liste %1$s contient déjà un votant nommé %2$s avec un email %3$s @@ -12,20 +30,3 @@ pollen.exception.user_wrong_password=Le mot de passe renseigné est incorrect pour l'utilisateur '%1$s'. pollen.exception.vote_doubloon= pollen.exception.vote_not_allowed= -pollen.configuration.siteUrl=Url publique de l'aplication (utilisée dans les emails envoyés) -pollen.configuration.dataDirectory=Répertoire des données de Pollen -pollen.configuration.defaultChoiceType=Choix par défaut utilisation lors de la création d'un sondage -pollen.configuration.defaultVoteCountingType=Type de dépouillement lors de la création d'un sondage -pollen.configuration.defaultPollType=Type de sondage lors de la création d'un sondage -pollen.configuration.charset=Encodnig de Pollen -pollen.configuration.nbVoteByPage=Nombre de votes à afficher par page -pollen.configuration.imageDirectory=répertoire où sont enregistrés les images -pollen.configuration.db.login=Login de l'utilisateur par défaut (Utilisateur crée lors du premier lancement de pollen) -pollen.configuration.db.password=Mot de passe de l'utilisateur par défaut (Utilisateur crée lors du premier lancement de pollen) -pollen.configuration.adminEmail=Email de l'utilisateur par défaut (Utilisateur crée lors du premier lancement de pollen) -pollen.configuration.contactEmail=Email pour le lien Contact -pollen.configuration.emailHost=Serveur d'envoie d'email -pollen.configuration.emailPort=Port du serveur d'envoi d'email -pollen.configuration.emailFrom=Email de l'envoyeur dans les emails -pollen.configuration.emaiDirectory=Répertoire des emails -pollen.configuration.feedDirectory=Répertoire des flux rss Added: trunk/src/site/fr/rst/configure.rst =================================================================== --- trunk/src/site/fr/rst/configure.rst (rev 0) +++ trunk/src/site/fr/rst/configure.rst 2012-05-02 08:24:42 UTC (rev 3341) @@ -0,0 +1,107 @@ +.. - +.. * #%L +.. * Pollen +.. * +.. * $Id$ +.. * $HeadURL$ +.. * %% +.. * Copyright (C) 2009 - 2012 CodeLutin +.. * %% +.. * This program is free software: you can redistribute it and/or modify +.. * it under the terms of the GNU Affero General Public License as published by +.. * the Free Software Foundation, either version 3 of the License, or +.. * (at your option) any later version. +.. * +.. * This program is distributed in the hope that it will be useful, +.. * but WITHOUT ANY WARRANTY; without even the implied warranty of +.. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.. * GNU General Public License for more details. +.. * +.. * You should have received a copy of the GNU Affero General Public License +.. * along with this program. If not, see <http://www.gnu.org/licenses/>. +.. * #L% +.. - +Configurer Pollen +----------------- + +Comment configuer Pollen +------------------------ + +Toute la configuration de Pollen se fait via un fichier nommé **pollen.properties**. + +Ce fichier peut se trouver à différents endroits sur la machine qui démarre Pollen : + +:: + + /etc/pollen.properties + ~/.config/pollen/pollen.properties + repertoireOuEstLancePollen/pollen.properties + +A noter que si le fichier est déposé dans plusieurs endroits, alors les +configurations se cumulent. + +Pour plus d'information sur les options disponibles, +rendez-vous sur la `page des options`_. + +Configurer l'adresse publique +----------------------------- + +L'adresse publique de Pollen est l'adresse utilisée dans les emails générés. + +On peut la configurer via la propriété suivante de la configuration : + +:: + + siteUrl=Adresse publique de votre instance de pollen (utilisé pour générer les liens d'accès au sondage dans les emails envoyés) + +Configurer l'envoi d'email +-------------------------- + +Pour que Pollen puisse envoyer des emails vous devez bien renseigner la +configuration: + +:: + + email_host= Serveur smtp pour envoyer les emails + email_port= Port du serveur smtp + email_from= Adresse de l'envoyeur de mail + +Configurer la base de données +----------------------------- + +Pollen utilise une base de données. Par défaut Pollen utilise une base type +h2. + +Pour modifier la configuration de la base de données, on modifie dans le +fichier de configuration les lignes: + +:: + + hibernate.connection.username=sa + hibernate.connection.password= + +Pour changer de type de base données, il faut modifier modidifer +les propriétés suivantes: + +:: + + hibernate.dialect=Dialect de la base + hibernate.connection.driver_class=Driver de la base + hibernate.connection.url=Url de connexion à la base + +Voici un tableau d'utilisation pour les bases usuelles: + ++-------------------------+------------------------------------------+-----------------------+------------------------------------------+ +| Type de base de données | dialect | driver | url de connexion | ++=========================+==========================================+=======================+==========================================+ +| H2 | org.hibernate.dialect.H2Dialect | org.h2.Driver | jdbc:h2:file:emplacementBaseH2/pollendb | ++-------------------------+------------------------------------------+-----------------------+------------------------------------------+ +| PostgreSql | org.hibernate.dialect.PostgreSQLDialect | org.postgresql.Driver | jdbc:postgresql:pollen | ++-------------------------+------------------------------------------+-----------------------+------------------------------------------+ +| MySql | org.hibernate.dialect.MySQLDialect | com.mysql.jdbc.Driver | jdbc:mysql:pollen | ++-------------------------+------------------------------------------+-----------------------+------------------------------------------+ + +.. _page des options: ./pollen-ui-struts2/application-config-report.html +.. _page des Téléchargements: http://www.chorem.org/projects/pollen/files +.. _Tomcat: http://tomcat.apache.org/ +.. _Jetty: http://eclipse.org/jetty/ Property changes on: trunk/src/site/fr/rst/configure.rst ___________________________________________________________________ Added: svn:keywords + Author Date Id Revision HeadURL Added: svn:eol-style + native Modified: trunk/src/site/fr/rst/index.rst =================================================================== --- trunk/src/site/fr/rst/index.rst 2012-05-01 18:08:12 UTC (rev 3340) +++ trunk/src/site/fr/rst/index.rst 2012-05-02 08:24:42 UTC (rev 3341) @@ -54,6 +54,15 @@ annuaires LDAP. - Vous pouvez importer/exporter des consultations. +Utiliser Pollen +--------------- + +Comment utiliser pollen ? + +- Utiliser notre `instance de Pollen`_, sans rien installer sur votre machine. +- `Télécharger Pollen`_ puis l'installer sur votre machine en suivant le + `guide d'installation`_ . + Mais encore... -------------- @@ -65,3 +74,6 @@ :alt: Page d'accueil de Pollen .. _modes de dépouillement: ./depouillement.html +.. _instance de Pollen: http://pollen.chorem.org/pollen +.. _Télécharger Pollen: http://www.chorem.org/projects/pollen/files +.. _guide d'installation: ./install.html Modified: trunk/src/site/fr/rst/install.rst.vm =================================================================== --- trunk/src/site/fr/rst/install.rst.vm 2012-05-01 18:08:12 UTC (rev 3340) +++ trunk/src/site/fr/rst/install.rst.vm 2012-05-02 08:24:42 UTC (rev 3341) @@ -21,51 +21,71 @@ .. * along with this program. If not, see <http://www.gnu.org/licenses/>. .. * #L% .. - -============ -Installation -============ +Installer Pollen +================ +Cette page décrit comment installer Pollen sur votre machine ou serveur. + Avant-propos ------------- +============ -Types d'installation -~~~~~~~~~~~~~~~~~~~~ +Modes d'installation +-------------------- -Il existe deux manières pour lancer Pollen: +Il existe deux modes d'installation de Pollen: -- en mode embarqué : dans ce mode Pollen possède un conteneur web embarqué, - il n'est pas pas nécessaire de posséder un conteneur web. +- **Mode embarqué** : dans ce mode Pollen se présente comme une application + autonome qui peut être lancée simplement sans besoin de conteneur web. -- en mode serveur : dans ce mode on déploit pollen dans un conteneur web - (tomcat, jetty,...) avec une configuration adapté pour un serveur. +- **Mode serveur** : dans ce mode on déploit Pollen dans un conteneur web + (tomcat, jetty,...) avec une configuration adaptée pour un serveur. Configurer Pollen -~~~~~~~~~~~~~~~~~ +----------------- -Pour modifier la configuration de Pollen, on doit créer un fichier nommé -**pollen.properties**. +Pour que Pollen soit pleinement opérationnel, il faut configurer deux choses : -Pour plus d'information sur les options disponibles, -rendez-vous sur la `page des options`_. +- l'adresse publique de Pollen (voir la section `Configurer l'adresse publique`_). +- la configuration d'envoie d'emails (voir la section `Configurer l'envoi d'email`_).). +Pour tout savoir sur la configuration de Pollen, reportez vous à la +`page de configuration`_. Se connecter à Pollen -~~~~~~~~~~~~~~~~~~~~~ +--------------------- Un utilisateur avec les droits d'administration est créé automatiquement -(identifiant **admin**, mot de passe **pollen**). +(identifiant **admin**, mot de passe **pollen**) lors du premier démarrage de +Pollen. Par mesure de sécurité il est important de supprimer cet utilisateur après avoir créer un autre compte administrateur. Installation en mode embarqué ------------------------------ +============================= +Installer +--------- + - Télécharger l'archive **${project.build.finalName}-bin.zip** sur la `page des Téléchargements`_. - Décompresser l'archive téléchargée. -- Lancer Pollen via l'un des deux commandes +Configurer +---------- + +En mode embarqué, le fichier de configuration **pollen.properties** se +trouve à la racine de l'archive décompressée. + +Toutes les données sont stoquées dans le répertoire *data*. + +Une base h2 est utilisée et stoquée (dans le répertoire *data/db*). + +Démarrer +-------- + +On démarre Pollen via l'un des deux commandes : + :: ./pollen.sh (sous linux) @@ -81,92 +101,43 @@ http://localhost:8888 -Configuration -~~~~~~~~~~~~~ -En mode embarqué, le fichier de configuration se trouve à la racine du fichier -décompressé. - -Toutes les données sont stoquées dans le répertoire *data*. - -Une base h2 est utilisée et stoquée (dans le répertoire *data/db*). - Installation en mode serveur ----------------------------- +============================ +Installer +--------- + - Télécharger le fichier **${project.build.finalName}.war** sur la `page des Téléchargements`_. - Renseigner la configuration (voir section suivante) -- Deployer le fichier war dans votre conteneur Web comme Tomcat_ ou Jetty_. -Configuration -~~~~~~~~~~~~~ +Configurer +---------- -Il faut créer un fichier de configuration nommé **pollen.properties** qui -peut se trouver dans l'un des répertoires suivants : +En mode serveur, Il faut créer un fichier de configuration nommé +**pollen.properties** qui peut se trouver dans l'un des répertoires suivants : :: /etc/pollen.properties ~/.config/pollen.properties -Par défaut les données seront stoquées dans le répertoire suivant +Par défaut les données seront stoquées dans le répertoire suivant : :: /var/local/pollen/data -Configuration avancés ---------------------- +Démarrer +-------- -Base des données -~~~~~~~~~~~~~~~~ +Déployer le fichier war dans votre conteneur Web comme Tomcat_ ou Jetty_. -Pollen utilise une base de données. Par défaut Pollen utilise une base type -h2. - -Pour modifier la configuration de la base de données, on modifie dans le -fichier de configuration les lignes: - -:: - - hibernate.connection.username=sa - hibernate.connection.password= - -Pour changer de type de base données, il faut modifier modidifer -les propriétés suivantes: - -:: - - hibernate.dialect=Dialect de la base - hibernate.connection.driver_class=Driver de la base - hibernate.connection.url=Url de connexion à la base - -Voici un tableau d'utilisation pour les bases usuelles: - -+-------------------------+------------------------------------------+-----------------------+------------------------------------------+ -| Type de base de données | dialect | driver | url de connexion | -+=========================+==========================================+=======================+==========================================+ -| H2 | org.hibernate.dialect.H2Dialect | org.h2.Driver | jdbc:h2:file:emplacementBaseH2/pollendb | -+-------------------------+------------------------------------------+-----------------------+------------------------------------------+ -| PostgreSql | org.hibernate.dialect.PostgreSQLDialect | org.postgresql.Driver | jdbc:postgresql:pollen | -+-------------------------+------------------------------------------+-----------------------+------------------------------------------+ -| MySql | org.hibernate.dialect.MySQLDialect | com.mysql.jdbc.Driver | jdbc:mysql:pollen | -+-------------------------+------------------------------------------+-----------------------+------------------------------------------+ - -Envoie des emails -~~~~~~~~~~~~~~~~~ - -Pour que Pollen puisse envoyer des emails vous devez modifier la configuration: - -:: - - email_host= Serveur smtp pour envoyer les emails - email_port= Port du serveur smtp - email_from= Adresse de l'envoyeur de mail - siteUrl= Adresse publique de votre instance de pollen (utilisé pour générer les liens d'accès au sondage dans les emails envoyés) - .. _page des options: ./pollen-ui-struts2/application-config-report.html +.. _page de configuration: ./configure.html .. _page des Téléchargements: http://www.chorem.org/projects/pollen/files .. _Tomcat: http://tomcat.apache.org/ .. _Jetty: http://eclipse.org/jetty/ +.. _Configurer l'adresse publique: ./configure.html#Configurer_ladresse_publique +.. _Configurer l'envoi d'email: ./configure.html#Configurer_lenvoi_demail Added: trunk/src/site/rst/configure.rst =================================================================== --- trunk/src/site/rst/configure.rst (rev 0) +++ trunk/src/site/rst/configure.rst 2012-05-02 08:24:42 UTC (rev 3341) @@ -0,0 +1,107 @@ +.. - +.. * #%L +.. * Pollen +.. * +.. * $Id$ +.. * $HeadURL$ +.. * %% +.. * Copyright (C) 2009 - 2012 CodeLutin +.. * %% +.. * This program is free software: you can redistribute it and/or modify +.. * it under the terms of the GNU Affero General Public License as published by +.. * the Free Software Foundation, either version 3 of the License, or +.. * (at your option) any later version. +.. * +.. * This program is distributed in the hope that it will be useful, +.. * but WITHOUT ANY WARRANTY; without even the implied warranty of +.. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.. * GNU General Public License for more details. +.. * +.. * You should have received a copy of the GNU Affero General Public License +.. * along with this program. If not, see <http://www.gnu.org/licenses/>. +.. * #L% +.. - +Configurer Pollen +----------------- + +Comment configuer Pollen +------------------------ + +Toute la configuration de Pollen se fait via un fichier nommé **pollen.properties**. + +Ce fichier peut se trouver à différents endroits sur la machine qui démarre Pollen : + +:: + + /etc/pollen.properties + ~/.config/pollen/pollen.properties + repertoireOuEstLancePollen/pollen.properties + +A noter que si le fichier est déposé dans plusieurs endroits, alors les +configurations se cumulent. + +Pour plus d'information sur les options disponibles, +rendez-vous sur la `page des options`_. + +Configurer l'adresse publique +----------------------------- + +L'adresse publique de Pollen est l'adresse utilisée dans les emails générés. + +On peut la configurer via la propriété suivante de la configuration : + +:: + + siteUrl=Adresse publique de votre instance de pollen (utilisé pour générer les liens d'accès au sondage dans les emails envoyés) + +Configurer l'envoi d'email +-------------------------- + +Pour que Pollen puisse envoyer des emails vous devez bien renseigner la +configuration: + +:: + + email_host= Serveur smtp pour envoyer les emails + email_port= Port du serveur smtp + email_from= Adresse de l'envoyeur de mail + +Configurer la base de données +----------------------------- + +Pollen utilise une base de données. Par défaut Pollen utilise une base type +h2. + +Pour modifier la configuration de la base de données, on modifie dans le +fichier de configuration les lignes: + +:: + + hibernate.connection.username=sa + hibernate.connection.password= + +Pour changer de type de base données, il faut modifier modidifer +les propriétés suivantes: + +:: + + hibernate.dialect=Dialect de la base + hibernate.connection.driver_class=Driver de la base + hibernate.connection.url=Url de connexion à la base + +Voici un tableau d'utilisation pour les bases usuelles: + ++-------------------------+------------------------------------------+-----------------------+------------------------------------------+ +| Type de base de données | dialect | driver | url de connexion | ++=========================+==========================================+=======================+==========================================+ +| H2 | org.hibernate.dialect.H2Dialect | org.h2.Driver | jdbc:h2:file:emplacementBaseH2/pollendb | ++-------------------------+------------------------------------------+-----------------------+------------------------------------------+ +| PostgreSql | org.hibernate.dialect.PostgreSQLDialect | org.postgresql.Driver | jdbc:postgresql:pollen | ++-------------------------+------------------------------------------+-----------------------+------------------------------------------+ +| MySql | org.hibernate.dialect.MySQLDialect | com.mysql.jdbc.Driver | jdbc:mysql:pollen | ++-------------------------+------------------------------------------+-----------------------+------------------------------------------+ + +.. _page des options: ./pollen-ui-struts2/application-config-report.html +.. _page des Téléchargements: http://www.chorem.org/projects/pollen/files +.. _Tomcat: http://tomcat.apache.org/ +.. _Jetty: http://eclipse.org/jetty/ Property changes on: trunk/src/site/rst/configure.rst ___________________________________________________________________ Added: svn:keywords + Author Date Id Revision HeadURL Added: svn:eol-style + native Modified: trunk/src/site/rst/index.rst =================================================================== --- trunk/src/site/rst/index.rst 2012-05-01 18:08:12 UTC (rev 3340) +++ trunk/src/site/rst/index.rst 2012-05-02 08:24:42 UTC (rev 3341) @@ -46,6 +46,15 @@ - You can import voters lists from CSV files or LDAP. - You can import/export votes/polls. +Use Pollen +---------- + +How to use Pollen? + +- Use our `shared instance of Pollen`_, with no install on your own computer. +- `Download Pollen`_ ans install it on our own computer following + `installation guide`_ . + But also... ----------- @@ -57,3 +66,6 @@ :alt: Pollen screenshot .. _vote counting methods: ./methods.html +.. _shared instance of Pollen: http://pollen.chorem.org/pollen +.. _Download Pollen: http://www.chorem.org/projects/pollen/files +.. _installation guide: ./install.html Deleted: trunk/src/site/rst/install.rst =================================================================== --- trunk/src/site/rst/install.rst 2012-05-01 18:08:12 UTC (rev 3340) +++ trunk/src/site/rst/install.rst 2012-05-02 08:24:42 UTC (rev 3341) @@ -1,99 +0,0 @@ -.. - -.. * #%L -.. * Pollen -.. * -.. * $Id$ -.. * $HeadURL$ -.. * %% -.. * Copyright (C) 2009 - 2012 CodeLutin -.. * %% -.. * This program is free software: you can redistribute it and/or modify -.. * it under the terms of the GNU Affero General Public License as published by -.. * the Free Software Foundation, either version 3 of the License, or -.. * (at your option) any later version. -.. * -.. * This program is distributed in the hope that it will be useful, -.. * but WITHOUT ANY WARRANTY; without even the implied warranty of -.. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -.. * GNU General Public License for more details. -.. * -.. * You should have received a copy of the GNU Affero General Public License -.. * along with this program. If not, see <http://www.gnu.org/licenses/>. -.. * #L% -.. - -Installation guide -================== - -.. Author: Nolwenn Rannou <rannou(a)codelutin.com> -.. Revision: $Revision$ -.. Date: $Date$ - -.. contents:: - -Web container -------------- - -To install the application, you just need to deploy the war archive in a web -container like Tomcat_. - -By default, a H2 database is created in the */tmp* directory. To modify this -behaviour, you only need to create the */etc/pollen.properties* file ( you can -put it into the directory from which you launch the application or in a -*".config/"* directory in your home directory) and to fill it with the following -properties :: - - # database configuration - hibernate.show_sql=false - hibernate.dialect=org.hibernate.dialect.H2Dialect - hibernate.connection.username=username - hibernate.connection.password=password - hibernate.connection.driver_class=org.h2.Driver - hibernate.connection.url=jdbc:h2:file://tmp/pollen/pollen - - # transfered pictures directory - upImgDir=/tmp/pollen/uploadedImages - - # maximal size of transfered pictures (in bytes) - upload.filesize-max=1048576 - upload.requestsize-max=10485760 - - # automatic email sending configuration - email_host=smtp.free.fr - email_port=25 - email_from=bot(a)pollen.org - - # syndication flux directory (Atom) - feedDir=/tmp/pollen/feeds - - # site adresse (used for reminder emails) - siteUrl=http://www.site.org/pollen/ - -For example, for a PostgreSQL database, we will have :: - - hibernate.dialect=org.hibernate.dialect.PostgreSQLDialect - hibernate.connection.driver_class=org.postgresql.Driver - hibernate.default_schema=public - -It may be necessary to redeploy the application after having modified this -file; - -A user with administration rights is automatically added (login "admin", -password "pollen"). For safety measures, it is really important to delete this -user (or modify its password) after having created another administrator account. - -Embedded container ------------------- - -Since pollen-1.1.1, the war bundle embed a servlet container based on winstone. -To run it, just launch with following command : - -:: - - java -jar pollen-x.x.x.war - - -Then open a browser to address : http://localhost:8080/. - -You can also use command line option to configure launch : http://winstone.sourceforge.net/#commandLine - -.. _Tomcat: http://tomcat.apache.org/ Copied: trunk/src/site/rst/install.rst.vm (from rev 3340, trunk/src/site/rst/install.rst) =================================================================== --- trunk/src/site/rst/install.rst.vm (rev 0) +++ trunk/src/site/rst/install.rst.vm 2012-05-02 08:24:42 UTC (rev 3341) @@ -0,0 +1,93 @@ +.. - +.. * #%L +.. * Pollen +.. * +.. * $Id$ +.. * $HeadURL$ +.. * %% +.. * Copyright (C) 2009 - 2012 CodeLutin +.. * %% +.. * This program is free software: you can redistribute it and/or modify +.. * it under the terms of the GNU Affero General Public License as published by +.. * the Free Software Foundation, either version 3 of the License, or +.. * (at your option) any later version. +.. * +.. * This program is distributed in the hope that it will be useful, +.. * but WITHOUT ANY WARRANTY; without even the implied warranty of +.. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.. * GNU General Public License for more details. +.. * +.. * You should have received a copy of the GNU Affero General Public License +.. * along with this program. If not, see <http://www.gnu.org/licenses/>. +.. * #L% +.. - +Installation guide +================== + +Web container +------------- + +To install the application, you just need to deploy the war archive in a web +container like Tomcat_. + +By default, a H2 database is created in the */tmp* directory. To modify this +behaviour, you only need to create the */etc/pollen.properties* file ( you can +put it into the directory from which you launch the application or in a +*".config/"* directory in your home directory) and to fill it with the following +properties :: + + # database configuration + hibernate.show_sql=false + hibernate.dialect=org.hibernate.dialect.H2Dialect + hibernate.connection.username=username + hibernate.connection.password=password + hibernate.connection.driver_class=org.h2.Driver + hibernate.connection.url=jdbc:h2:file://tmp/pollen/pollen + + # transfered pictures directory + upImgDir=/tmp/pollen/uploadedImages + + # maximal size of transfered pictures (in bytes) + upload.filesize-max=1048576 + upload.requestsize-max=10485760 + + # automatic email sending configuration + email_host=smtp.free.fr + email_port=25 + email_from=bot(a)pollen.org + + # syndication flux directory (Atom) + feedDir=/tmp/pollen/feeds + + # site adresse (used for reminder emails) + siteUrl=http://www.site.org/pollen/ + +For example, for a PostgreSQL database, we will have :: + + hibernate.dialect=org.hibernate.dialect.PostgreSQLDialect + hibernate.connection.driver_class=org.postgresql.Driver + hibernate.default_schema=public + +It may be necessary to redeploy the application after having modified this +file; + +A user with administration rights is automatically added (login "admin", +password "pollen"). For safety measures, it is really important to delete this +user (or modify its password) after having created another administrator account. + +Embedded container +------------------ + +Since pollen-1.1.1, the war bundle embed a servlet container based on winstone. +To run it, just launch with following command : + +:: + + java -jar pollen-x.x.x.war + + +Then open a browser to address : http://localhost:8080/. + +You can also use command line option to configure launch : http://winstone.sourceforge.net/#commandLine + +.. _Tomcat: http://tomcat.apache.org/ Property changes on: trunk/src/site/rst/install.rst.vm ___________________________________________________________________ Added: svn:keywords + Author Date Id Revision HeadURL Added: svn:mergeinfo + Added: svn:eol-style + native Modified: trunk/src/site/site_en.xml =================================================================== --- trunk/src/site/site_en.xml 2012-05-01 18:08:12 UTC (rev 3340) +++ trunk/src/site/site_en.xml 2012-05-02 08:24:42 UTC (rev 3341) @@ -89,15 +89,13 @@ <item name="Libre-Entreprise" href="http://www.libre-entreprise.org/"/> </links> - <menu name="Download"> - <item name="Download" + <menu name="Install"> + <item name="Download Pollen" href="http://www.chorem.org/projects/pollen/files"/> + <item name="Install Pollen" href="install.html"/> + <item name="Configure Pollen" href="configure.html"/> </menu> - <menu name="Install"> - <item name="Install" href="install.html"/> - </menu> - <menu name="Demo"> <item name="Demo" href="http://pollen.chorem.org/"/> </menu> Modified: trunk/src/site/site_fr.xml =================================================================== --- trunk/src/site/site_fr.xml 2012-05-01 18:08:12 UTC (rev 3340) +++ trunk/src/site/site_fr.xml 2012-05-02 08:24:42 UTC (rev 3341) @@ -89,15 +89,13 @@ <item name="Libre-Entreprise" href="http://www.libre-entreprise.org/"/> </links> - <menu name="Téléchargement"> - <item name="Téléchargement" + <menu name="Installation"> + <item name="Télécharger Pollen" href="http://www.chorem.org/projects/pollen/files"/> + <item name="Installer Pollen" href="install.html"/> + <item name="Configurer Pollen" href="configure.html"/> </menu> - <menu name="Installation"> - <item name="Installation" href="install.html"/> - </menu> - <menu name="Demo"> <item name="Demo" href="http://pollen.chorem.org/"/> </menu>

1 0

r3340 - trunk/src/site/fr/rst
by tchemit＠users.chorem.org May 1, 2012

May 1, 2012

Author: tchemit Date: 2012-05-01 20:08:12 +0200 (Tue, 01 May 2012) New Revision: 3340 Url: http://chorem.org/repositories/revision/pollen/3340 Log: fix doc refs #538: Improve install documentation Modified: trunk/src/site/fr/rst/install.rst.vm Modified: trunk/src/site/fr/rst/install.rst.vm =================================================================== --- trunk/src/site/fr/rst/install.rst.vm 2012-05-01 17:58:28 UTC (rev 3339) +++ trunk/src/site/fr/rst/install.rst.vm 2012-05-01 18:08:12 UTC (rev 3340) @@ -137,6 +137,7 @@ les propriétés suivantes: :: + hibernate.dialect=Dialect de la base hibernate.connection.driver_class=Driver de la base hibernate.connection.url=Url de connexion à la base

1 0

r3339 - trunk/pollen-persistence
by tchemit＠users.chorem.org May 1, 2012

May 1, 2012

Author: tchemit Date: 2012-05-01 19:58:28 +0200 (Tue, 01 May 2012) New Revision: 3339 Url: http://chorem.org/repositories/revision/pollen/3339 Log: optimize dependencies Modified: trunk/pollen-persistence/pom.xml Modified: trunk/pollen-persistence/pom.xml =================================================================== --- trunk/pollen-persistence/pom.xml 2012-05-01 17:55:38 UTC (rev 3338) +++ trunk/pollen-persistence/pom.xml 2012-05-01 17:58:28 UTC (rev 3339) @@ -40,10 +40,10 @@ <groupId>org.nuiton</groupId> <artifactId>nuiton-utils</artifactId> </dependency> -  + </dependency> <dependency> <groupId>org.nuiton.topia</groupId> <artifactId>topia-persistence</artifactId>

1 0

r3338 - trunk/src/site/fr/rst
by tchemit＠users.chorem.org May 1, 2012

May 1, 2012

Author: tchemit Date: 2012-05-01 19:55:38 +0200 (Tue, 01 May 2012) New Revision: 3338 Url: http://chorem.org/repositories/revision/pollen/3338 Log: fix doc refs #538: Improve install documentation Modified: trunk/src/site/fr/rst/install.rst.vm Modified: trunk/src/site/fr/rst/install.rst.vm =================================================================== --- trunk/src/site/fr/rst/install.rst.vm 2012-05-01 17:34:13 UTC (rev 3337) +++ trunk/src/site/fr/rst/install.rst.vm 2012-05-01 17:55:38 UTC (rev 3338) @@ -21,6 +21,7 @@ .. * along with this program. If not, see <http://www.gnu.org/licenses/>. .. * #L% .. - +============ Installation ============ @@ -42,70 +43,26 @@ ~~~~~~~~~~~~~~~~~ Pour modifier la configuration de Pollen, on doit créer un fichier nommé -*pollen.properties*. +**pollen.properties**. Pour plus d'information sur les options disponibles, rendez-vous sur la `page des options`_. -Stoquage des données -~~~~~~~~~~~~~~~~~~~~ -Pollen utilise une base de données. Par défaut Pollen utilise une base type -h2. - -Lors du premier lancement de Pollen, l'utilisateur admin / admin sera crée dans -la base de données. - -Pour modifier la configuration de la base de données, on modifie dans le -fichier de configuration les lignes: - -:: - - hibernate.connection.username=sa - hibernate.connection.password= - -Pour changer de type de base données, il faut modifier modidifer -les propriétés suivantes: - -:: - hibernate.dialect=Dialect de la base - hibernate.connection.driver_class=Driver de la base - hibernate.connection.url=Url de connexion à la base - -Voici un tableau d'utilisation pour les bases usuelles: - -+-------------------------+---------+--------------------------------+-----------------------+------------------------------------------+ -+ Type de base de données | dialect | driver | url de connexion + -+-------------------------+---------+--------------------------------+-----------------------+------------------------------------------+ -+ H2 | org.hibernate.dialect.H2Dialect | org.h2.Driver | jdbc:h2:file:emplacementBaseH/pollendb + -+ PostgreSql | org.hibernate.dialect.PostgreSQLDialect | org.postgresql.Driver | jdbc:postgresql:pollen + -+-------------------------+---------+--------------------------------+-----------------------+------------------------------------------+ - -Envoie des emails -~~~~~~~~~~~~~~~~~ - -Pour que Pollen puisse envoyer des emails vous devez modifier la configuration: - -:: - - email_host= Serveur smtp pour envoyer les emails - email_port= Port du serveur smtp - email_from= Adresse de l'envoyeur de mail - siteUrl= Adresse publique de votre instance de pollen (utilisé pour générer les liens d'accès au sondage dans les emails envoyés) - Se connecter à Pollen ~~~~~~~~~~~~~~~~~~~~~ Un utilisateur avec les droits d'administration est créé automatiquement -(identifiant *admin*, mot de passe *pollen*). Par mesure de sécurité il est -important de supprimer cet utilisateur après avoir créer un autre compte -administrateur. +(identifiant **admin**, mot de passe **pollen**). +Par mesure de sécurité il est important de supprimer cet utilisateur +après avoir créer un autre compte administrateur. + Installation en mode embarqué ----------------------------- -- Télécharger l'archive ${project.build.finalName}-bin.zip sur la - `page des Téléchargements`. +- Télécharger l'archive **${project.build.finalName}-bin.zip** sur la + `page des Téléchargements`_. - Décompresser l'archive téléchargée. - Lancer Pollen via l'un des deux commandes @@ -137,15 +94,15 @@ Installation en mode serveur ---------------------------- -- Télécharger le fichier ${project.build.finalName}.war sur la - `page des Téléchargements`. +- Télécharger le fichier **${project.build.finalName}.war** sur la + `page des Téléchargements`_. - Renseigner la configuration (voir section suivante) - Deployer le fichier war dans votre conteneur Web comme Tomcat_ ou Jetty_. Configuration ~~~~~~~~~~~~~ -Il faut créer un fichier de configuration nommé *pollen.properties* qui +Il faut créer un fichier de configuration nommé **pollen.properties** qui peut se trouver dans l'un des répertoires suivants : :: @@ -159,6 +116,55 @@ /var/local/pollen/data +Configuration avancés +--------------------- + +Base des données +~~~~~~~~~~~~~~~~ + +Pollen utilise une base de données. Par défaut Pollen utilise une base type +h2. + +Pour modifier la configuration de la base de données, on modifie dans le +fichier de configuration les lignes: + +:: + + hibernate.connection.username=sa + hibernate.connection.password= + +Pour changer de type de base données, il faut modifier modidifer +les propriétés suivantes: + +:: + hibernate.dialect=Dialect de la base + hibernate.connection.driver_class=Driver de la base + hibernate.connection.url=Url de connexion à la base + +Voici un tableau d'utilisation pour les bases usuelles: + ++-------------------------+------------------------------------------+-----------------------+------------------------------------------+ +| Type de base de données | dialect | driver | url de connexion | ++=========================+==========================================+=======================+==========================================+ +| H2 | org.hibernate.dialect.H2Dialect | org.h2.Driver | jdbc:h2:file:emplacementBaseH2/pollendb | ++-------------------------+------------------------------------------+-----------------------+------------------------------------------+ +| PostgreSql | org.hibernate.dialect.PostgreSQLDialect | org.postgresql.Driver | jdbc:postgresql:pollen | ++-------------------------+------------------------------------------+-----------------------+------------------------------------------+ +| MySql | org.hibernate.dialect.MySQLDialect | com.mysql.jdbc.Driver | jdbc:mysql:pollen | ++-------------------------+------------------------------------------+-----------------------+------------------------------------------+ + +Envoie des emails +~~~~~~~~~~~~~~~~~ + +Pour que Pollen puisse envoyer des emails vous devez modifier la configuration: + +:: + + email_host= Serveur smtp pour envoyer les emails + email_port= Port du serveur smtp + email_from= Adresse de l'envoyeur de mail + siteUrl= Adresse publique de votre instance de pollen (utilisé pour générer les liens d'accès au sondage dans les emails envoyés) + .. _page des options: ./pollen-ui-struts2/application-config-report.html .. _page des Téléchargements: http://www.chorem.org/projects/pollen/files .. _Tomcat: http://tomcat.apache.org/

1 0