Fichiers des modules
ps_module_file
- ProTellMyShop Pro uniquement
- Écriture · aperçu + validation
- Enregistre: interrupteur Modules (24 h)
- Modules · interrupteur, 24 h
- Visible dès l’installation
Lit les fichiers d’un module et, quand il n’y a pas d’autre moyen, les modifie après une sauvegarde ; ces modifications disparaissent à la mise à jour du module.
TellMyShop Free: Non. Cet outil fait uniquement partie de TellMyShop Pro. TellMyShop Free ne contient que des rapports prêts à l’emploi qui lisent votre boutique.
Demandez au chat
« Le module xyzshipping enregistre sans cesse « Undefined index id_carrier ». Trouve la ligne et corrige-la. »
Exemple d’aperçu
Fichier module:xyzshipping/classes/Rates.php, 18 240 -> 18 262 octets. Sauvegarde avant l’enregistrement. Syntaxe PHP : OK. - $carrier = $params['id_carrier']; + $carrier = $params['id_carrier'] ?? 0; Remarque : cette modification sera perdue à la prochaine mise à jour de xyzshipping.
Détails techniques
Fichiers d’un module installé : action=list (dossier, path facultatif), read (path, from_line), edit (path + search/replace, ou content). ATTENTION : les modifications des fichiers d’un module sont PERDUES lors de sa mise à jour. Modifiez l’apparence d’un module avec ps_override_module_template (copie du template dans le thème) ; ne modifiez les fichiers d’un module que si c’est le seul moyen (par exemple pour corriger un bug PHP), et prévenez l’utilisateur. La syntaxe des fichiers PHP est vérifiée avant l’enregistrement et chaque écriture est sauvegardée. Restauration : ps_restore_file_backup.
Paramètres
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| action | enum: list | read | edit | oui | list | read | edit. |
| module | string | oui | Nom technique du module. |
| path | string | quand | Chemin relatif au dossier du module (list : sous-dossier facultatif). 300 caractères maximum. |
| from_line | integer | non | read : ligne de départ (400 lignes par appel). |
| search | string | non | edit : fragment exact à remplacer (doit apparaître exactement une fois). 100 000 caractères maximum. |
| replace | string | non | edit : le nouveau fragment. 100 000 caractères maximum. |
| content | string | non | edit : tout le nouveau contenu (au lieu de search/replace). 500 000 caractères maximum. |
| confirm | boolean | non | false (par défaut) renvoie un aperçu et n’enregistre rien. true exécute, uniquement après que l’utilisateur a validé l’aperçu, avec change_token. |
| change_token | string | quand | Jeton issu de l’aperçu. Obligatoire avec confirm=true. Valable 30 minutes, à usage unique, lié aux arguments et à l’état des données de l’aperçu. |
Limites
read : 400 lignes par appel, fichiers jusqu’à 1 Mo. edit : fichiers texte uniquement (php, tpl, twig, css, js, json, yml, xml, txt, md, html, htaccess, scss, svg) ; le fragment doit apparaître exactement une fois ; exige l’interrupteur Modules. Les écritures de fichiers comptent dans la limite d’écritures de fichiers (20 par heure par défaut), partagée par tous les outils de fichiers (réglable dans la carte Réglages : sécurité, alertes, limites). Le module du connecteur lui-même est hors limites.
Ce que vous voyez avant tout enregistrement
Le chat appelle d’abord l’outil sans le confirmer. Le module renvoie un aperçu (valeurs actuelles et nouvelles) et un jeton à usage unique valable 30 minutes. Le chat vous montre l’aperçu et n’enregistre la modification qu’après votre oui.
Outils liés
- Surcharger le template d’un module ps_override_module_template
- Lister les sauvegardes de fichiers ps_list_file_backups
- Restaurer une sauvegarde de fichier ps_restore_file_backup
- Lire les journaux PrestaShop ps_get_logs
Cas d’usage avec cet outil
- Modifier l’apparence d’un module sans la perdre à la prochaine mise à jour
- Changer un texte figé dans le bloc d’un module
- Refaire le style du bloc des produits phares sur la page d’accueil
- Corriger les titres et les descriptions d’images du diaporama de la page d’accueil
- Vérifier vos personnalisations de module avant de mettre le module à jour
- Modifier le comportement d’un module quand changer son apparence ne suffit pas
- Vérifier et ajuster les réglages des modules
- Corriger un bug dans le code d’un module en attendant le correctif de l’auteur
Dernière mise à jour: 2026-10-11