Skip to content

UPLOAD_FEATURE.md

Latest commit

 

History

History
111 lines (86 loc) · 4.47 KB

UPLOAD_FEATURE.md

File metadata and controls

111 lines (86 loc) · 4.47 KB

Fonctionnalité d'Upload de Média - Support Plugin

Description

La fonctionnalité d'upload de média a été ajoutée aux formulaires de support du backend/dashboard et du frontend. Les utilisateurs peuvent maintenant joindre des fichiers à leurs tickets de support depuis l'interface d'administration WordPress et depuis le frontend du site.

Fonctionnalités

Interface Utilisateur

  • Zone de drag & drop : Les utilisateurs peuvent glisser-déposer des fichiers directement dans la zone d'upload
  • Sélection multiple : Possibilité de sélectionner plusieurs fichiers à la fois
  • Prévisualisation : Affichage de la liste des fichiers sélectionnés avec leur taille
  • Suppression : Possibilité de supprimer des fichiers avant l'envoi
  • Validation : Vérification de la taille des fichiers (limite 1GB par fichier)

Formats Supportés

  • Images : JPG, JPEG, PNG, GIF
  • Documents : PDF, DOC, DOCX, TXT
  • Archives : ZIP, RAR
  • Autres : Tous les types MIME supportés par ClickUp

Style Wireframe

L'interface respecte le style wireframe demandé :

  • Couleurs : Noir, gris, blanc uniquement
  • Pas de border-radius
  • Design minimaliste et moderne

Implémentation Technique

Frontend (Site Public)

  • Template : templates/support-form.php - Ajout du champ d'upload
  • CSS : assets/css/style.css - Styles pour l'interface d'upload
  • JavaScript : assets/js/script.js - Gestion du drag & drop et envoi

Backend (Dashboard WordPress)

  • Widget : includes/class-support-dashboard-widget.php - Formulaire d'upload dans le dashboard
  • CSS : assets/css/dashboard.css - Styles pour l'interface d'upload du dashboard
  • JavaScript : Intégré dans le widget - Gestion du drag & drop et envoi

Backend (Traitement)

  • PHP : includes/class-support-plugin.php - Traitement de l'upload
  • API : includes/class-clickup-api.php - Upload vers ClickUp

Fonctionnement

  1. L'utilisateur sélectionne ou glisse des fichiers
  2. Les fichiers sont validés côté client (taille, format)
  3. Lors de la soumission du formulaire, les fichiers sont envoyés avec les données
  4. Le backend crée d'abord le ticket dans ClickUp
  5. Puis upload chaque fichier vers le ticket créé
  6. Retourne un message de succès avec le statut des uploads

Sécurité

Validation des Fichiers

  • Vérification de la taille (max 1GB par fichier)
  • Nettoyage des noms de fichiers (suppression des caractères spéciaux)
  • Validation des types MIME
  • Vérification de l'existence des fichiers temporaires

Protection

  • Nonce WordPress pour la sécurité AJAX
  • Sanitisation des données
  • Gestion des erreurs d'upload

Utilisation

Pour les Utilisateurs Frontend

  1. Ouvrir le formulaire de support sur le site public
  2. Remplir les champs obligatoires
  3. Glisser des fichiers dans la zone d'upload ou cliquer pour sélectionner
  4. Vérifier la liste des fichiers sélectionnés
  5. Supprimer les fichiers non désirés si nécessaire
  6. Envoyer le formulaire

Pour les Administrateurs (Dashboard)

  1. Aller dans le dashboard WordPress
  2. Localiser le widget "Nouveau Ticket Support"
  3. Remplir les champs obligatoires (Sujet, Priorité, Message)
  4. Optionnellement ajouter l'URL de la page concernée
  5. Glisser des fichiers dans la zone d'upload ou cliquer pour sélectionner
  6. Vérifier la liste des fichiers sélectionnés
  7. Supprimer les fichiers non désirés si nécessaire
  8. Cliquer sur "Créer le ticket"

Messages de Retour

  • Succès complet : "Ticket créé avec succès et X pièce(s) jointe(s) uploadée(s)"
  • Succès partiel : "Ticket créé avec succès. X fichier(s) uploadé(s), Y erreur(s) : [détails]"
  • Erreur d'upload : "Ticket créé avec succès. Erreur lors de l'upload des pièces jointes : [détails]"

Configuration

Aucune configuration supplémentaire n'est requise. La fonctionnalité est activée par défaut si les fonctionnalités frontend sont activées dans les paramètres du plugin.

Limitations

  • Taille maximale par fichier : 1GB (limite ClickUp)
  • Formats supportés selon la documentation ClickUp
  • Dépendance à l'API ClickUp pour l'upload
  • Nécessite une connexion internet stable pour les gros fichiers

Maintenance

Logs

Les erreurs d'upload sont loggées dans les logs du plugin et affichées à l'utilisateur.

Débogage

En cas de problème, vérifier :

  1. Les permissions de fichiers temporaires
  2. La connectivité à l'API ClickUp
  3. Les logs d'erreur WordPress
  4. La taille et le format des fichiers