Installation de Dudle

L'installation de Dudle peut se faire sur un serveur LAMP (Ubuntu 16.04). Pour faciliter la tâche, les développeurs ont mis à disposition des images Docker (que je n'ai pas testées). Vous pouvez trouver l'ensemble des sources et de la documentation (sommaine) sur le lien suivant : https://github.com/kellerben/dudle.

Installer l'environnement nécessaire

Dudle nécessite l'installation de Ruby, GIT, Ruby-Gettext, Gettext, Potool ((pour les traductions) et Make (pour la compilation).

 sudo apt-get install ruby ruby-gettext rubygems ruby-dev libxml2-dev zlib1g-dev
 sudo gem install ratom

Et il faut activer les mods cgi et auth_digest :

a2enmod cgi
a2enmod auth_digest
service apache2 restart

Installation de Dudle

Ensuite, dans le dossier parent où vous souhaitez installer le logiciel, il faut cloner le dépôt.

git clone https://github.com/kellerben/dudle.git

Un dossier dudle contenant les sources vient d'être cloné sur votre serveur. Ne pas oublier de donner les droits www-data au dossier .

chown -R www-data:www-data dudle/

Avant de fonctionner, il est nécessaire de copier le fichier de configuration

cp -p config_sample.rb config.rb

Petite modification à réaliser sur le fichier .htaccess pour indiquer que le dossier choisi doit être en environnement Ruby.

SetEnv RUBYLIB /var/www/dudle/

Il faut également modifier la langue

#SetEnv LC_ALL "en_US.UTF-8"
#Ici nous commentons la ligne qui indique que la langue est anglais US et nous ajoutons une ligne pour dire que le français est la langue de l'application.
#SetEnv LC_ALL "fr_FR.UTF-8"

En enfin, des variables peuvent être ajoutées et personnalisées :

SetEnv GIT_AUTHOR_NAME="http user"
SetEnv GIT_AUTHOR_EMAIL=foo@example.org
SetEnv GIT_COMMITTER_NAME="$GIT_AUTHOR_NAME"
SetEnv GIT_COMMITTER_EMAIL="$GIT_AUTHOR_EMAIL"

Il faut ensuite télécharger le fichier de la langue utilisée (un fichier *.mo). En l'occurence, pour nous, le français.

for i in locale/fr; do wget -O $i/dudle.mo https://dudle.inf.tu-dresden.de/locale/`basename $i`/dudle.mo ; done

Une fois que tout cela est effectué, il reste à vérifier que votre configuration est correcte. Pour cela, rendez vous sur la page  http(s)://$YOUR_SERVER/check.cgi  pour vérifier que les paramètres fonctionnent.

Si tout fonctionne, vous devez avoir le message suivant :

Si tel est le cas, alors votre installation de Dudle est prête à être utilisée. Dans le cas inverse, vérifier bien les fichiers comme la configuration du VirtualHost, le fichier .htaccess et les mods Apache.

Il ne reste plus qu'à aller sur l'url de votre installation pour profiter de Dudle.

L'interface austère de Dudle

L'interface est épurée mais cela permettra une personnalisation plus facile en modifiant le CSS de l'application.

Pour aller plus loin avec Dudle

Modifier l'apparence de l'application

Pour personnaliser l'apparence de l'application Dudle au couleur de l'entité, il faut créer un dossier css et lui donner les droits www-data. Par la suite, il faudra copier le fichier css de default dans le dossier css avec un nouveau nom

mkdir css
chown -R www-data:www-data css
cp default.css css/nouveaucss.css

Ensuite, sur l'application et dans l'onglet "Personnalisation", vous pourrez choisir votre feuille de style.

Supprimer automatiquement les anciens sondages

Il est possible de mettre en place une tâche CRON pour supprimer automatique les anciens sondages. Par exemple, le script dudle_cleanup.sh mis à disposition par le développeur, supprime les sondages qui ont plus de 90 jours. Vous pouvez bien entendu changer le nombre de jours à loisir.

Ensuite, pour l'exécuter régulièrement, il faut lui donner des droits d'exécution puis paramétrer la tâche CRON

chmod +x dudle_cleanup.sh

puis faire la commande `crontab -e` pour éditer les tâches et ajouter la tâche suivant :

@daily /CHEMIN/dudle/dudle_cleanup.sh

Elle permet d'exécuter le script tous les jours à minuit.

Activer le mode maintenance

Il est également possible d'activer le mode de maintenance s'il y a besoin de changer quelque chose dans l'application. En utilisant ce mode, l'ensemble des utilisateurs verront un message de maintenance.

Pour activer le mode de maintenance, il suffit simplement de créer un fichier maintenance.html à la racine de l'installation, qui peut inclure un message particulier.