====== LSTU, raccourcisseur d'URL ======

===== Procédure d'installation =====

1. Création d'un sous-domaine [[https://vrgl.fr|https://vrgl.fr]] dans Ouvaton

2. Création du domaine lien.viregul.fr dans Yunohost

3. Installation de l'application Lstu

- choisir le domaine vrgl.fr

- Theme choisi "milligun"

- Définition d'un mot passe admin

Patienter sans paniquer.

Retour dans Yunohost / domaines

Et regénérer le certificat dans Domaines / vrgl.fr / Installer un certificat Let's encrypt

==== Configuration - personnalisation ====

Copie de ''/var/www/lstu/themes/milligun'' en ''/var/www/lstu/themes/viregul''

Changement du nom du site et du nom du logo (et taille) dans le fichier ''viregul/templates/layouts/default.html.ep''
<code html5>
<div class="float-left hidden-xs logo">
<img src="<%= url_for('/img/lstuviregul.png') %>" alt="lstu logo" width="100" height="100">
</div>
<%= link_to url_for('/') ⇒ (class ⇒ 'link_nocol') ⇒ begin %><h1 class="hennypenny">Et couic, le lien !</h1><% end %>


</code>

Création d'un dossier ''/var/www/lstu/themes/viregul/public/img/'' et dépot d'une image ''lstuviregul.png'' dedans.

Modification du fichier ''/var/www/lstu/lstu.conf'' pour changer :
<code>

theme = milligun

</code>

en

<code>
theme = viregul

</code>

Surcharge d'une classe css dans themes/viregul/public/css/milli-lstu.min.css

<code css>
.float-left.hidden-xs.logo {
    padding-right: 20px;
}


</code>

Et relancer le service avec :

<code>
sudo systemctl restart lstu

</code>

**Sécurité - mot de passe admin**

Changer la clef par défaut de chiffrement des cookies (pwgen 24) :

<code>
secrets => ['xei5WoohieChaileilaihook'],

</code>

Pour changer le mot de passe admin, éditer le fichier lstu.conf et lancer dans un terminal :

<code>
echo -n nouveaumotdepasse | sha256sum

</code>

Remplacer la chaine en sortie dans la valeur (en laissant la virgule à la fin) par exemple :

hashed_adminpwd ⇒ 'lach9iHuth1phoo4ohseeliec2FeShei4seingeek4tu2aixoade',

Et relancer le service :
<code>

systemctl restart lstu.service

</code>

Ceci vous permettra d'accéder aux stats, de supprimer des liens…

===== Mise à jour lstu =====

Sauvegarder /var/www/lstu dans le but de conserver : ''/var/www/lstu/thmes/viregul'' et ''/var/www/lstu/lstu.conf''

Une fois la mise à jour effectuée, comparer les 2 lstu.conf et rétablir dans lstu.conf :

  * contact ⇒ contact@viregul.fr
  * secrets pour le chiffrement des cookies
  * hashed_adminpwd ⇒ remettre l'ancienne valeur
  * theme ⇒ viregul
  * disable_api ⇒ 1, pour désactiver l'API ouverte

Vérifier si le dossier "viregul" est encore présent dans les pads.

Et redémarrer le service :

<code>
systemctl restart lstu

</code>

===== Mise à jour buster =====

Après une mise à jour vers buster, les vieux modules perl [[https://github.com/YunoHost-Apps/lstu_ynh/issues/47|sont obsolètes]], il faut les re-générer :
<code>

sudo cpan Carton
cd /var/www/lstu/
sudo rm -rf local/
sudo carton install --deployment --without=sqlite --without=mysql
sudo systemctl restart lstu.service

</code>

Et vérifier que le service est bien actif et enable :

<code>
sudo systemctl status lstu.service

</code>