File Navigator WP Registry grade C-. High-severity findings · 1 findingWP RegistryHigh-severity findings · 1 findingOpen the reportC-

Un navigateur de fichiers pour WordPress, propulsé par Symfony Finder, Twig et une interface moderne.

✨ Fonctionnalités

• 📂 Navigation dans les dossiers (arborescence cliquable)
• 🖼️ Aperçu des images (miniature avec zoom au survol)
• 📑 Icônes spécifiques pour les PDF
• 📤 Upload de fichiers (glisser‑déposer ou sélecteur)
• ⬇️ Téléchargement d’un fichier ou d’un ZIP multiple
• 📋 Copier / Couper / Coller (presse‑papiers avec localStorage)
• ✏️ Renommer un fichier ou un dossier
• 🗑️ Supprimer des fichiers ou dossiers
• 📁 Créer un nouveau dossier
• 🔒 Gestion des permissions par rôle WordPress
• 🔍 Tri dynamique par nom, taille, date (menus déroulants)
• 📅 Affichage de la date au format JJ/MM/AAAA HH:MM
• 📱 Responsive et paramétrable (largeur/hauteur fixe)
• ⚡ AJAX pour toutes les actions (pas de rechargement)
• 🎨 Barre d’outils fixe (sticky) lors du défilement

📦 Prérequis

• WordPress 5.8 ou supérieur
• PHP 7.4 ou supérieur
• Extension PHP zip (pour le téléchargement groupé)
• Composer (pour l’installation en développement)

📥 Installation

Via le backend WordPress (recommandé)

1. Téléchargez l’archive ZIP depuis votre dépôt ou la page de release.
2. Allez dans Extensions → Ajouter → Téléverser une extension.
3. Choisissez le fichier ZIP et cliquez sur Installer maintenant.
4. Activez l’extension “File Navigator”.

Via FTP / SFTP

1. Décompressez l’archive dans le dossier /wp-content/plugins/.
2. Activez l’extension dans le menu Extensions de WordPress.

🧩 Utilisation de la shortcode

Insérez la shortcode [filenavigator] dans n’importe quelle page ou article.

Paramètres disponibles

Tri dynamique

Le tri peut être modifié directement depuis l’interface grâce aux menus déroulants :

• Nom (A→Z / Z→A)
• Taille (croissant / décroissant)
• Date (plus ancien / plus récent)

Les paramètres sont conservés dans l’URL (?sort=size&order=desc) lors de la navigation.

Exemples d’utilisation

[filenavigator]

Navigateur dans le dossier uploads, largeur 100%, hauteur 400px.
Date affichée en JJ/MM/AAAA HH:MM.

[filenavigator root="downloads" width="800px" height="600px" extensions="jpg,png,pdf"]

Explorer le dossier uploads/downloads, afficher uniquement les fichiers JPG, PNG et PDF.

[filenavigator root="/home/site/public_html/documents" sort="mtime" order="desc"]

Dossier absolu, tri par date de modification du plus récent au plus ancien.

[filenavigator public_download="false"]

Téléchargement uniquement autorisé aux utilisateurs connectés.

[filenavigator frame="true" background="#f9f9f9" toolbar_background="#e3f0fa" breadcrumb_background="#dce8f0" width="90%" height="500px"]

Navigateur dans le dossier uploads, largeur 100%, hauteur 400px. Modification des couleurs.

🔐 Permissions (capabilités)

Personnalisation : utilisez le filtre WPFN_permissions dans votre functions.php pour modifier les droits.

add_filter('WPFN_permissions', function($perms) {
    $perms['can_delete'] = current_user_can('manage_options'); // admins seulement
    return $perms;
});

🛠️ Développement

Installation locale

git clone https://github.com/johnburnout/FileNavigator.git
cd FileNavigator
composer install

Structure du projet

filenavigator/
├── assets/
│   ├── css/style.css
│   └── js/main.js
├── src/
│   ├── FileNavigator/
│   │   ├── FileNavigatorService.php
│   │   ├── FileOperationService.php
│   │   └── SecurityChecker.php
│   └── Shortcode/
│       └── FileNavigatorShortcode.php
├── templates/
│   └── filenavigator.twig
├── vendor/                (généré par Composer)
├── composer.json
├── composer.lock
├── filenavigator.php
├── README.md
└── readme.txt

Tests

Activez le mode debug dans wp-config.php :

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', true);

Les erreurs apparaîtront dans wp-content/debug.log.

📝 Changelog

1.1.2 – 23 août 2026

• Ajout des paramètres frame, background, toolbar_background et breadcrumb_background pour personnaliser l’apparence
• Possibilité de désactiver le cadre ou de modifier les couleurs de fond

• 1.1.1 – 23 août 2026

• Téléchargement direct en cliquant sur le nom du fichier
• Lien de téléchargement sur chaque fichier (images, PDF, etc.)
• Ajout du lien vers le profil GitHub de l'auteur dans l'en-tête du plugin

1.1.0 – 22 août 2026

• Ajout des paramètres width et height avec barre de défilement
• Barre d’outils fixe (sticky)
• Aperçu des images au survol avec zoom
• Icônes spécifiques pour les PDF
• Gestion des permissions par rôle WordPress
• Filtre WPFN_permissions pour personnalisation
• Correction de la détection des dossiers (is_dir)
• Liens cliquables pour les dossiers
• Tri dynamique par nom, taille, date (menus déroulants)
• Affichage de la date au format JJ/MM/AAAA HH:MM
• Amélioration de la sécurité (SecurityChecker)

1.0.0 – 20 août 2026

• Version initiale : navigateur de fichiers, shortcode, Symfony Finder, Twig, barre d’outils AJAX (upload, download, copier, couper, coller, renommer, supprimer, nouveau dossier)

👤 Auteur

Jean Roussie – GitHub

📄 Licence

Ce projet est sous licence GPL-2.0+ – voir le fichier LICENSE pour plus de détails.

🤝 Contribution

Les contributions sont les bienvenues !

1. Forkez le projet
2. Créez votre branche (git checkout -b feature/ma-fonctionnalite)
3. Commitez (git commit -m 'Ajout de ma fonctionnalité')
4. Pushez (git push origin feature/ma-fonctionnalite)
5. Ouvrez une Pull Request

🐛 Signaler un bug

Utilisez l’onglet Issues de GitHub.

Profitez d’une gestion de fichiers simple et puissante directement dans WordPress ! 🚀