52 lines
4.4 KiB
Markdown
52 lines
4.4 KiB
Markdown
# Thème WordPress `cgt-wp-theme` — Union Locale CGT Foix Haute-Ariège
|
|
|
|
Thème WordPress sur mesure, rapide et souverain conçu pour le site officiel de l'**Union Locale CGT Foix Haute-Ariège** (`https://cgt-fha.fr/`).
|
|
|
|
L'Union Locale CGT de Foix et de la Haute-Ariège rassemble tous les syndicats CGT de son périmètre et assure le rattachement direct des salarié·e·s isolé·e·s (TPE, PME, commerces, artisanat, associations sans section syndicale) grâce à son **syndicat multiprofessionnel (Multipros)**.
|
|
|
|
---
|
|
|
|
## Fonctionnalités principales
|
|
|
|
- **Bandeau d'alerte mobilisation auto-expirant :** bandeau rouge CGT pleine largeur paramétrable (texte, lien, date et heure d'expiration automatique).
|
|
- **Vitrine locale prioritaire :** mise en avant des 3 derniers articles locaux publiés dans WordPress (*Sur le terrain à Foix et en Haute-Ariège*), avec hooks prêts pour l'agenda (`cgt-wp-calendar`) et les formulaires militants (`cgt-wp-forms`).
|
|
- **Actualité confédérale `cgt.fr` automatisée :** récupération directe depuis `https://www.cgt.fr/` et `/actualites` (1 article *À la une* + 3 articles récents) avec cache Transient (3 h), sauvegarde hors-ligne, tâche `WP-Cron` (2 h) et bouton de rafraîchissement manuel — sans polluer `wp_posts`.
|
|
- **Parcours militants & Réseau syndical :** section dédiée aux salarié·e·s isolé·e·s & TPE (*Multipros*), rappel du droit à la formation syndicale (*CFESES*), bloc Application Mobile activable à la demande et cartes illustrées du réseau CGT (UD CGT 09, Confédération CGT, La NVO, IHS CGT, INDECOSA-CGT).
|
|
- **SEO local, OpenGraph & Performance :** balises `<title>`, `<meta name="description">` et OpenGraph natifs (`fr_FR`), alerte si l'indexation WordPress est bloquée, chargement léger sans jQuery, sans Bootstrap/Tailwind CDN ni Google Fonts externes (conforme RGPD).
|
|
- **Administration 100 % paramétrable & préservation des réglages :** tous les textes, visuels, icônes, coordonnées, menus et liens sont modifiables depuis **Apparence > Réglages UL CGT**. Lors des mises à jour, **100 % des personnalisations enregistrées en base (`wp_options`), les menus et les médias sont strictement préservés**.
|
|
|
|
---
|
|
|
|
## Installation
|
|
|
|
1. Téléchargez l'archive du thème depuis le dépôt Gitea (`https://git.cgt-fha.fr/Union_Locale_CGT_Foix_Haute-Ariege/cgt-wp-theme/archive/main.zip`) ou clonez le dépôt dans `wp-content/themes/` :
|
|
```bash
|
|
git clone https://git.cgt-fha.fr/Union_Locale_CGT_Foix_Haute-Ariege/cgt-wp-theme.git cgt-fha
|
|
```
|
|
2. Dans l'administration WordPress, rendez-vous dans **Apparence > Thèmes** et activez **Union Locale CGT Foix Haute-Ariège**.
|
|
3. Personnalisez vos textes, logos, coordonnées et le bandeau mobilisation dans **Apparence > Réglages UL CGT**, puis configurez vos menus dans **Apparence > Menus**.
|
|
|
|
---
|
|
|
|
## Mise à jour en un clic depuis WordPress (Gitea public)
|
|
|
|
Le module `inc/class-cgt-gitea-updater.php` connecte nativement WordPress au dépôt public Gitea sans nécessiter aucun jeton d'authentification :
|
|
|
|
1. **Détection automatique :** WordPress interroge périodiquement (ou lors d'un clic sur *Vérifier à nouveau* dans **Tableau de bord > Mises à jour**) l'en-tête `Version:` de `https://git.cgt-fha.fr/Union_Locale_CGT_Foix_Haute-Ariege/cgt-wp-theme/raw/branch/main/style.css`.
|
|
2. **Téléchargement & renommage transparent :** lorsque vous lancez la mise à jour en un clic depuis WordPress, l'archive `/archive/main.zip` est téléchargée puis automatiquement renommée vers le dossier actif du thème (`get_stylesheet()`, par exemple `cgt-fha`).
|
|
3. **Préservation totale des données :** aucune mise à jour ne réinitialise `cgt_fha_options`, les menus WordPress ou les médias téléversés. Les réglages restent lus dynamiquement via `wp_parse_args( get_option( 'cgt_fha_options' ), $defaults )`.
|
|
|
|
### Publier une nouvelle version sur Gitea
|
|
|
|
1. Modifiez les fichiers du thème selon vos besoins.
|
|
2. Incrémentez le numéro de version dans :
|
|
- l'en-tête `Version:` de `style.css` ;
|
|
- la constante `CGT_FHA_VERSION` dans `functions.php` (et `CGT_FHA_SCHEMA_VERSION` dans `inc/theme-options.php` en cas de migration structurelle non destructive).
|
|
3. Validez et poussez sur la branche `main` :
|
|
```bash
|
|
git add .
|
|
git commit -m "Release vX.Y.Z"
|
|
git push origin main
|
|
```
|
|
4. Dans WordPress (**Tableau de bord > Mises à jour** ou **Apparence > Thèmes**), cliquez sur **Mettre à jour**.
|