qrcode.chapril.org/README.md

94 lines
4.1 KiB
Markdown
Raw Normal View History

2020-03-15 21:22:53 +01:00
# ![](themes/dark/icons/32.png) LibreQR
2019-08-13 21:17:08 +02:00
## Présentation
Une interface Web pour générer des codes QR en PHP.
## Démo
2019-01-26 15:17:36 +01:00
Une instance de ce service est disponible à l'adresse [https://qr.antopie.org](https://qr.antopie.org).
2019-08-13 21:17:08 +02:00
2019-08-14 17:12:36 +02:00
## Fonctionnement
LibreQR inclus un plugin [OpenSearch](https://developer.mozilla.org/docs/Web/OpenSearch), ce qui permet de l'ajouter comme moteur de recherche dans Firefox et de sauvegarder vos paramètres.
Vous pouvez ainsi générer un code QR directement depuis la barre de recherche avec les réglages de LibreQR utilisés lors de l'ajout comme moteur de recherche.
2019-08-14 17:12:36 +02:00
Un [WebManifest](https://developer.mozilla.org/docs/Web/Manifest) est également inclus, ce qui permet de mieux l'intégrer au système via Fennec (Firefox Android) ou Chromium.
2020-03-23 16:27:30 +01:00
Les codes QR générés sont placés dans le dossier temp/, nommés avec le nombre de caractères aléatoires indiqué dans config.inc.php (32 par défaut), puis supprimés après le temps indiqué dans config.inc.php (7 jours par défaut).
2019-08-13 21:17:08 +02:00
## Installation
2019-08-14 17:12:36 +02:00
### Générique
2020-03-16 18:34:49 +01:00
Je développe directement dans master, donc en production téléchargez plutôt une version stable dans [l'onglet Versions](https://code.antopie.org/miraty/libreqr/releases).
2019-08-13 21:17:08 +02:00
Placez ce code source dans un serveur Web avec PHP, tout simplement.
2019-08-14 17:12:36 +02:00
### YunoHost
2020-03-23 14:51:46 +01:00
J'ai créé [un paquet](https://code.antopie.org/miraty/qr_ynh/) pour [YunoHost](https://yunohost.org/).
2020-03-23 14:51:46 +01:00
Vous pouvez l'installer depuis l'interface Web d'administration ou avec cette commande :
2019-08-14 17:12:36 +02:00
```
2020-03-23 14:51:46 +01:00
sudo yunohost app install qr
2019-08-14 17:12:36 +02:00
```
2019-08-13 21:17:08 +02:00
## Thèmes
### Changer de thème
Dans config.inc.php, donnez à $theme le nom du thème voulu.
2019-08-13 21:17:08 +02:00
Par défaut, trois thèmes sont proposés :
2019-08-13 21:17:08 +02:00
* dark, le thème par défaut, sombre. Il est utilisé ici : <https://qr.antopie.org>
* light, thème clair
2020-03-23 14:51:46 +01:00
* parinux, un thème bleu, créé pour [Bastet](https://bastet.parinux.org), le CHATON de [Parinux](https://parinux.org). Il est utilisé ici : <https://codeqr.parinux.org>
2019-08-13 21:17:08 +02:00
### Créer un thème
* Copiez themes/dark vers themes/[nom de votre thème]
* Complétez theme.php en fonction des couleurs CSS voulues dans l'interface
* Modifiez l'image source.png en fonction de votre thème
* Pour générer automatiquement les icônes aux tailles correctes, utilisez
```
php themes/resize.php [nom de votre thème]
```
Cela nécessitera d'avoir installé [ImageMagick](https://imagemagick.org) et
[pngquant](https://pngquant.org).
2019-08-13 21:17:08 +02:00
2020-03-23 14:51:46 +01:00
## Contribuer
Si vous souhaitez rapporter un bug, vous pouvez ouvrir un ticket sur <https://code.antopie.org/miraty/libreqr/issues> après vous être créé un compte (méthode préférée) ou me contacter d'une autre manière.
## Contact
Si vous voulez me contacter, par exemple pour demander un éclaircissement sur le fonctionnement de LibreQR ou pour signaler un bug, vous pouvez le faire par :
* Matrix : @miraty:matrix.antopie.org
* courriel : [miraty+libreqr@antopie.org](mailto:miraty+libreqr@antopie.org) (GPG : [B16B 12A8 957B 2EC7 9659 04A6 B82D 15F0 3E67 B2B5](https://miraty.antopie.org/B16B12A8957B2EC7965904A6B82D15F03E67B2B5.asc))
* le Fédiverse : [@Miraty@oc.todon.fr](https://oc.todon.fr/@Miraty)
2019-08-13 21:17:08 +02:00
## Bibliothèques tierces
Ce code source inclus :
* [phpqrcode](https://github.com/t0k4rt/phpqrcode) pour générer les codes QR
* [La police Ubuntu packagée pour le Web](https://github.com/earaujoassis/ubuntu-fontface)
2020-03-23 14:51:46 +01:00
* [lessphp](http://leafo.net/lessphp) pour compiler le [Less](http://lesscss.org)
2019-08-13 21:17:08 +02:00
## Licence
2020-03-16 18:34:49 +01:00
[AGPLv3+](https://code.antopie.org/miraty/libreqr/src/branch/master/LICENSE)
2019-08-13 21:17:08 +02:00
LibreQR est un logiciel libre ; vous pouvez le diffuser et le modifier suivant les termes de la GNU Affero General Public License telle que publiée par la Free Software Foundation ; soit la version 3 de cette licence, soit (à votre convenance) une version ultérieure.
2019-08-13 21:17:08 +02:00
LibreQR est diffusé dans lespoir quil sera utile, mais SANS AUCUNE GARANTIE ; sans même une garantie implicite de COMMERCIALISATION ou dADÉQUATION À UN USAGE PARTICULIER. Voyez la GNU Affero General Public License pour plus de détails.
2019-08-13 21:17:08 +02:00
Vous devriez avoir reçu une copie de la GNU Affero General Public License avec ce code. Sinon, consultez <https://www.gnu.org/licenses/>