documentation/services/qrcode.libre-service.eu.md

# Service qrcode.libre-service.eu

Service de génération de code QR basé sur le logiciel libre Libreqr : https://code.antopie.org/miraty/libreqr/

# Installation

## Pré-requis

Installation des pré-requis :
```
apt install php7.4-gd imagemagick pngquant libapache2-mod-php7.4
```

## L'application

Choix de l'installation par le dépôt Git :
```
cd /var/www/
git clone https://code.antopie.org/miraty/libreqr.git qrcode.libre-service.eu
```

Sélection de la dernière branche officielle :
```
cd /var/www/qrcode.libre-service.eu/
git checkout -b 1.3.0
```

Créer une branche maison :
```
git checkout -b libre-service.eu-1.3.0
```

S'assurer des permissions :
```
chown www-data:www-data /var/www/qrcode.libre-service.eu/temp/
chmod ug+rwx /var/www/qrcode.libre-service.eu/temp/
```

## L'arborescence du service 

Tout service a son espace dédié :
```
mkdir -p /srv/qrcode.libre-service.eu/
cd /srv/qrcode.libre-service.eu/
ln -s /var/www/qrcode.libre-service.eu www
```

Création d'un dépôt `tools` à lier à un projet `qrcode.libre-service.eu-tools` sur la forge Devinsy :
```
cd /srv/qrcode.libre-service.eu/tools/
echo "# Service qrcode.libre-service.eu" > README.md
git remote add origin ssh://gitea@forge.libre-service.eu:/libre-service.eu/qrcode.libre-service.eu-tools.git
git push -u origin master
```

# Personnalisation

## Version

Veiller à mettre la bonne version dans le fichier `/var/www/qrcode.libre-service.eu/inc.php` :
```
-$libreqrVersion = "1.4.0dev";
+$libreqrVersion = "libre-service.eu-1.3.0";
```

## Pied de page (1/2)

Modifier le fichier `/var/www/qrcode.libre-service.eu/locales/en.php` :
```
-  'metaText_legal' => "LibreQR " . $libreqrVersion . " is a free software whose <a href='https://code.antopie.org/miraty/libreqr/'>source code</a> is available under the terms of the <abbr title='GNU Affero General Public License version 3 or any later version'><a href='LICENSE.html'>AGPLv3</a>+</abbr>.",
+  'metaText_legal' => "<a href='https://code.antopie.org/miraty/libreqr/'>LibreQR</a> version " . $libreqrVersion . " is a free software whose <a href='https://forge.devinsy.fr/libre-service.eu/qrcode.libre-service.eu-libreqr/'>source code</a> is available under the terms of the <abbr title='GNU Affero General Public License version 3 or any later version'><a href='LICENSE.html'>AGPLv3</a>+</abbr>.",
```

Modifier le fichier `/var/www/qrcode.libre-service.eu/locales/fr.php` :
```
-  'metaText_legal' => "LibreQR " . $libreqrVersion . " est un logiciel libre dont le <a href='https://code.antopie.org/miraty/libreqr/'>code source</a> est disponible selon les termes de l'<abbr title='GNU Affero General Public License version 3 ou toute version ultérieure'><a href='LICENSE.html'>AGPLv3</a>+</abbr>.",
+  'metaText_legal' => "<a href='https://code.antopie.org/miraty/libreqr/'>LibreQR</a> version" . $libreqrVersion . " est un logiciel libre dont le <a href='https://forge.devinsy.fr/libre-service.eu/qrcode.libre-service.eu-libreqr'>code source</a> est disponible selon les termes de l'<abbr title='GNU Affero General Public License version 3 ou toute version ultérieure'><a href='LICENSE.html'>AGPLv3</a>+</abbr>.",
```

## Pied de page (2/2)

Ajouter une phrase au pied de page dans le fichier `/var/www/qrcode.libre-service.eu/config.inc.php` :
```
-$customTextEnabled = false;
-$customText = "This LibreQR instance is hosted by <a href='https://foo.example/'>foo</a>.";
+$customTextEnabled = true;
+$customText = "Cette instance de LibreQR est hébergée  par <a href='https://www.libre-service.eu/'>https://www.libre-service.eu/</a>.";
```


## Thème personnalisé

Créer le thème personnalisé :
```
cd /var/www/qrcode.libre-service.eu/themes/
cp -a libreqr libre-service.eu
chmod -R go+rX libre-service.eu
```

Activer le thème personnalisé dans `config.inc.php` :
```
-$theme = "libreqr";
+$theme = "libre-service.eu";
```

Modifier le thème dans `themes/libre-service.eu/theme.php` :
```
$variablesTheme = array(
  "bg" => "#67a3f2",
  "bgField" => "#2e5281",
  "bgTextField" => "white",
  "fgTextField" => "black",
  "fgDefaultTextField" => "#999999",
  "bgHelp" => "#2e5281",
  "border" => "#2e5281",
  "borderHover" => "#808080",
  "borderFocus" => "white",
  "text" => "white",
  "secondaryText" => "white"
```

Modifier le style dans `style.less` :
```
 #txt {
   background-color: @bgTextField;
-  color: @text;
+  color: @fgTextField;
[…] 
 #txt::placeholder {
-  color: @secondaryText;
+  color: @fgDefaultTextField;
   opacity: 1;
```

## Favicon

Placer le fichier favicon source dans `themes/libre-service.eu/icons/source.png` puis :
```
cd /var/www/qrcode.libre-service.eu/
php themes/resize.php libre-service.eu
```

## Logo principal
Placer le fichier logo dans `themes/libre-service.eu/icons/libre-service.eu-libreqr-logo.png` puis modifier `index.php` :
```
-          <img alt="" id="logo" src="themes/<?php echo $theme; ?>/icons/128.png">
+          <img alt="" id="logo" src="themes/<?php echo $theme; ?>/icons/libre-service.eu-libreqr-logo.png">
```

## Titre
Modifier `index.php` :
```
-            <h1>LibreQR</h1>
+            <h1>QRCode.libre-service.eu</h1>
```


# Mise à jour
TODO