# Contribuer à Tropratik e-Facture

Merci de votre intérêt pour **Tropratik e-Facture** ! Les contributions — corrections de bugs, améliorations, traductions — sont les bienvenues.

## Licence des contributions

Le projet est distribué sous licence **GPLv2 or later**. En proposant une contribution (issue, pull request, correctif), vous acceptez qu'elle soit intégrée et distribuée sous cette même licence.

La GPL vous autorise à modifier et à redistribuer le plugin. Si vous diffusez une version modifiée, le code source correspondant doit rester disponible sous GPL.

> **Une demande, pas une obligation :** si vous améliorez le plugin, nous vous serions reconnaissants de **proposer vos changements en amont** (issue ou pull request) plutôt que de maintenir un fork isolé. Cela profite à toute la communauté et nous permet de rester informés des évolutions.

## Signaler un bug

Ouvrez une *issue* en incluant autant que possible :

- la version du plugin, de **WordPress**, de **WooCommerce** et de **PHP** ;
- le mode de stockage des commandes utilisé (HPOS ou classique) ;
- les **étapes de reproduction** détaillées ;
- le comportement attendu et le comportement constaté ;
- les éventuels messages d'erreur ou journaux (en prenant soin de **masquer toute donnée sensible** : identifiants PISTE, mots de passe techniques, mots de passe proxy, SIRET de clients, etc.).

⚠️ **Ne publiez jamais de secrets** (Client Secret PISTE, mots de passe du compte technique ou du proxy) dans une issue publique.

## Proposer une amélioration

1. Ouvrez d'abord une *issue* pour décrire votre idée et en discuter.
2. *Forkez* le dépôt, créez une branche dédiée (`fix/...` ou `feature/...`).
3. Implémentez votre changement en respectant les conventions ci-dessous.
4. Ouvrez une *pull request* claire, expliquant le problème résolu et la solution.

## Conventions de code

- **PHP 8.1+** requis.
- Suivre les **WordPress Coding Standards** (WPCS).
- Préfixer le code public : fonctions/options en `tropratik_ef_`, classes en `Tropratik_EF_`.
- **Sécurité** : échapper toutes les sorties (`esc_html`, `esc_attr`, `esc_url`…), valider/assainir toutes les entrées, vérifier les *nonces* et les capacités (`current_user_can`) sur les actions admin/AJAX.
- **Internationalisation** : toute chaîne visible doit passer par les fonctions de traduction avec le text domain `tropratik-e-facture`. Après ajout de chaînes, régénérez le fichier `languages/tropratik-e-facture.pot`.
- Restez dans le périmètre de votre correctif : évitez les refactorisations non liées.

## Traductions

Le plugin est prêt pour la traduction. Vous pouvez traduire les chaînes via [translate.wordpress.org](https://translate.wordpress.org) ou en proposant un fichier `.po`/`.mo` basé sur `languages/tropratik-e-facture.pot`.

## À propos du nom « Tropratik »

Le code est libre sous GPL, mais le **nom « Tropratik » et le logo sont des marques** non couvertes par la licence GPL. Si vous redistribuez une version modifiée, merci de la publier **sous un autre nom** afin d'éviter toute confusion avec la version officielle.

## Contact

Pour toute question, utilisez les *issues* du dépôt ou le support de [Tropratik.fr](https://www.tropratik.fr).
