138 lines
No EOL
4.6 KiB
Markdown
138 lines
No EOL
4.6 KiB
Markdown
# 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` :
|
|
```
|
|
- "bg-light" => "white",
|
|
- "bgField-light" => "#eeeeee",
|
|
+ "bg-light" => "#ff766c",
|
|
+ "bgField-light" => "#65c6e8",
|
|
```
|
|
|
|
## 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 |