Module de Petites Annonces pour ZwiiCMS

---

📌 Description

Ce module permet de gérer des petites annonces sur votre site ZwiiCMS. Il offre les fonctionnalités suivantes :

• Ajout, édition, modifications et suppression d'annonces.
• Configuration de l'affichage (nombre d'annonces par page, format de date, etc.).
• Gestion des états (brouillon/publié).
• Affichage des annonces sous forme de carte ou d'article détaillé.

---

Prérequis

• ZwiiCMS installé et fonctionnel.
• PHP 7.4 ou supérieur.

---

Installation

1. Téléchargez le module et placez-le dans le dossier module/ de votre installation ZwiiCMS.
2. Activez le module depuis l'interface d'administration de ZwiiCMS.

---

⚙️ Configuration

Options disponibles

• Nombre d'annonces par page : 6, 12, 18, 24 ou 36.
• Hauteur du texte : 200, 400 ou 600 caractères, ou article complet.
• Affichage de la date et de l'heure : Personnalisez le format d'affichage.

Comment configurer ?

1. Allez dans la section "Configuration des annonces" du module.
2. Sélectionnez les options souhaitées et enregistrez.

---

Utilisation

Ajouter une annonce

1. Cliquez sur "Ajouter une annonce".
2. Remplissez les champs (titre, contenu, dates de publication, etc.).
3. Choisissez l'état (brouillon ou publié).
4. Enregistrez.

Éditer une annonce

1. Sélectionnez l'annonce à modifier dans la liste.
2. Modifiez les champs nécessaires.
3. Enregistrez les changements.

Modifier une annonce

1. Sélectionnez le n° d'annonce à modifier dans la liste.
2. Identifiez-vous avec pseudo et MDP.
3. Modifiez les champs nécessaires.
4. Enregistrez les changements.
5. Ici, vous pouvez aussi supprimer l'annonce.

Supprimer une annonce

1. Sélectionnez l'annonce à supprimer.
2. Confirmez la suppression.

---

📨 Notification par email

• L'administrateur peut être notifié par email, pour l'ajout ou la modification d'une annonce, en vue de modération.

---

📂 Structure des données

• Les annonces sont stockées dans le dossier site/data/annonces/ sous forme de fichiers JSON. Chaque annonce est identifiée par un ID unique (ex: annonce_1).
• Les images sont stockées dans le dossier site/data/annonces/images/.

---

🔒 Rôles et permissions

• Visiteur : Peut consulter la liste des annonces et les articles détaillés.
  Peut ajouter une annonce à l'aide d'un formulaire. (texte brut et une image). Peut modifier ou supprimer son annonce.
• Éditeur : Peut ajouter, éditer, configurer, modérer les annonces reçues des visiteurs et les supprimer.

---

Personnalisation

Vous pouvez personnaliser l'affichage des annonces en modifiant les fichiers de vue (views/) du module. Les fichiers suivants sont disponibles :

• index.php : Liste des annonces.
• article.php : Affichage détaillé d'une annonce.
• addPublic.php : Formulaire d'ajout d'une annonce côté visiteurs.
• modifyAnnonce.php : Formulaire de modification ou suppression d'une annonce côté visiteurs.
• add.php : Formulaire d'ajout et modération d'une annonce côté admin.
• edit.php : Formulaire d'édition d'une annonce.
• config.php : Formulaire de configuration.

---

Exemple d'utilisation

// Exemple d'ajout d'une annonce via le code
$annonceData = [
 'title' => 'Titre de l\'annonce',
 'content' => 'Contenu de l\'annonce...',
 'userId' => 1,
 'state' => true,
 'publishedOn' => date('Y-m-d H:i:s'),
 'publishedOff' => ''
];
$this->setData(['module', 'annonces', 'posts', 'annonce_1', $annonceData]);

---

📌 Auteur

Sur une idée de @niko, inspiré du module News de ZwiiCMS.
Et ensuite adapté, enrichi et développé en 2025 par [Lemimi].
Grand merci à @fred pour le développement de ZwiiCMS.

---

🪪 Licence

• Licence sous GNU GPL v3.0 ou ultérieure.

Utilisation libre : commerciale, personnelle, éducative.
Modification : autorisée pour tous.
Distribution : possible sous les mêmes conditions.
Copyleft : les versions modifiées doivent conserver la même licence.
Auteur : attribution obligatoire.
Garantie : aucune garantie légale.