=== Texas Hold'em Cards — Documentation française ===
Version : 1.1.1
Auteur  : wouf (https://site2wouf.fr)
Licence : GPLv2 ou ultérieure

== Description ==

**Texas Hold'em Cards** permet d'insérer des cartes de poker dans vos articles,
pages et commentaires WordPress via un simple shortcode.

Le shortcode principal est `[wouf_card]`. Un alias configurable (par défaut `[card]`)
est également disponible.
Les cartes sont générées en SVG inline : nettes à toute taille, sans image externe,
sans JavaScript.

**Utilisation de base :**

  [wouf_card]As Kh[/wouf_card]

Affiche un As de Pique et un Roi de Cœur.

== Notation ==

Rangs   : A K Q J T 9 8 7 6 5 4 3 2
Couleurs : s (♠ pique)  h (♥ cœur)  d (♦ carreau)  c (♣ trèfle)

Jetons spéciaux :
  ??  carte face cachée (dos de carte)
  PP  paquet face caché (pile de cartes)
  _   demi-carte d'espacement (sépare visuellement les cartes privatives du tableau)

Les espaces, virgules, points-virgules, tirets et barres verticales sont acceptés
comme séparateurs visuels entre les cartes et sont ignorés lors de l'analyse.

== Paramètres du shortcode ==

  width   Largeur des cartes en pixels (défaut : réglage du plugin, 60 px).
          Hauteur calculée automatiquement (ratio ×1,4).
          Valeurs : 20 à 300.

  align   Alignement des cartes.
          Valeurs : inline (défaut), left, center, right.
          Les valeurs non-inline enveloppent la main dans un bloc centré/aligné.

  colors  Jeu 2 couleurs ou 4 couleurs.
          Valeurs : 2 (défaut : ♠♣ noir, ♥♦ rouge)
                    4 (♠ noir · ♥ rouge · ♦ bleu · ♣ vert)
          Le mode 4 couleurs est standard dans les clients de poker en ligne.

  gap     Espace entre les cartes en pixels.
          Défaut : ~8 % de la largeur des cartes.

== Réglages du plugin ==

Settings → Texas Hold'em Cards :
  - Alias du shortcode (défaut : card)
  - Largeur par défaut des cartes
  - Alignement par défaut
  - Jeu de couleurs par défaut (2 ou 4 couleurs)
  - Activer les shortcodes dans les commentaires

== Exemples ==

[wouf_card]As Kh[/wouf_card]
→ Affichage inline : A♠ K♥

[wouf_card width="90" align="center"]As Kh _ Td Jc Qh[/wouf_card]
→ Cartes plus grandes, centrées. Cartes privatives séparées du flop par un espaceur.

[wouf_card align="center"]?? Kh _ Td Jc Qh _ PP[/wouf_card]
→ Carte cachée, K♥, tableau, paquet restant.

[wouf_card colors="4"]As Kh Qd Jc[/wouf_card]
→ Mode 4 couleurs : ♠ noir, ♥ rouge, ♦ bleu, ♣ vert.

[wouf_card gap="2"]As Kh[/wouf_card]
→ Espacement réduit entre les cartes (2 px).

[wouf_card width="100" align="center"]2s 2h 2d 2c[/wouf_card]
→ Quatre deuces en grande taille.

== Installation ==

1. Dans votre administration WordPress, allez dans Extensions → Ajouter,
   recherchez « Texas Hold'em Cards » et cliquez sur Installer maintenant.
   Ou déposez manuellement le dossier texas-holdem-cards dans /wp-content/plugins/.
2. Activez le plugin dans Extensions → Extensions installées.
3. Facultatif : ajustez les réglages dans Settings → Texas Hold'em Cards.
4. Utilisez le shortcode [wouf_card] dans vos articles, pages, widgets ou commentaires.

== Questions fréquentes ==

Le plugin fonctionne-t-il avec l'éditeur de blocs (Gutenberg) ?
  Oui. Utilisez un bloc Shortcode et collez votre shortcode [wouf_card].

À quoi sert le mode 4 couleurs ?
  En mode 4 couleurs, chaque couleur a une teinte distincte : ♠ noir, ♥ rouge,
  ♦ bleu, ♣ vert. C'est le standard des logiciels de poker en ligne, très utile
  pour la lisibilité des situations de tirage couleur (flush draw).

Les lecteurs peuvent-ils poster des mains dans les commentaires ?
  Oui — activez « Shortcodes dans les commentaires » dans les réglages du plugin.

Que se passe-t-il si j'écris une carte invalide (ex. Xz) ?
  Les cartes invalides sont silencieusement ignorées. Le shortcode ne produit
  jamais de sortie incorrecte.

Y a-t-il des requêtes externes ?
  Non. Tout est du SVG inline généré côté serveur. Pas de police externe,
  pas de CDN, pas de JavaScript.

Puis-je personnaliser le style des cartes en CSS ?
  L'élément conteneur porte les classes wouf-texas-holdem-cards-hand et
  wouf-texas-holdem-cards-colors-2 ou wouf-texas-holdem-cards-colors-4.
  Les SVG utilisent des styles inline ; utilisez !important si besoin.

== Changelog ==

= 1.1.1 =
* Suppression de l'appel explicite à load_plugin_textdomain() — les traductions
  des plugins hébergés sur WordPress.org sont chargées automatiquement depuis
  WordPress 4.6.
* Renommage de toutes les fonctions, options et groupes de réglages internes avec
  le préfixe unique wouf_texas_holdem_cards_ pour éviter toute collision de noms.

= 1.1.0 =
* Ajout du mode 4 couleurs (♠ noir · ♥ rouge · ♦ bleu · ♣ vert) — réglage global
  et attribut colors par shortcode.
* Ajout de l'attribut gap pour contrôler l'espacement entre les cartes.
* Ajout du support des shortcodes dans les commentaires (activé par défaut,
  désactivable dans les réglages).
* Amélioration du design SVG des cartes : bordure intérieure fine, coins affinés,
  symbole central légèrement agrandi.
* Classes CSS wouf-texas-holdem-cards-colors-2 / wouf-texas-holdem-cards-colors-4 sur le conteneur pour faciliter le style.
* Page de réglages mise à jour avec les nouvelles options et exemples.

= 1.0.3 =
* Lien "Réglages" ajouté sur la page des extensions.
* Ajout des réglages : alias, largeur par défaut, alignement par défaut.
* [wouf_card] conservé comme shortcode principal permanent.

= 1.0.2 =
* Ajout d'une page de documentation légère dans l'administration.

= 1.0.1 =
* Ajout de [wouf_card] comme shortcode principal.
* [card] conservé comme alias rétrocompatible.
* Support des séparateurs visuels dans le contenu du shortcode.

= 1.0.0 =
* Version initiale.
* Cartes SVG inline — aucune image requise.
* Shortcode [card] avec paramètres width et align.
* Jetons spéciaux : ?? (dos), PP (paquet), _ (espaceur).
