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 modules/ 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.

📂 Structure des données

• Les annonces sont stockées dans le dossier data/annonce/ 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 data/annonce/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', 'annonce', '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.