Override module template
ps_override_module_template
Write · preview + approveBlock 3 · Appearance & deployments (service connector, off by default)Service connector onlyBlock off after install
Changes how a module looks without touching the module itself.
Ask Claude
„Hide the newsletter consent text under the footer form, without touching the module itself.”
Example preview
New override themes/classic/modules/ps_emailsubscription/views/templates/hook/ps_emailsubscription.tpl (copied from the module). Change at line 41. Smarty validation: OK. Backup will be created.
Technical details
Creates or changes an override of a module template in the active theme (themes/{theme}/modules/{module}/...), so the change survives module updates and the module's own files stay untouched. Validation and backup work as in ps_write_theme_file. Service connector only (allowlisted IP addresses).
Parameters
Parameter names are not confirmed in module 0.3.0 yet and may change.
| Name | Type | Required | Description |
|---|---|---|---|
| module | string | no | Technical module name (ps_list_modules). |
| template | string | no | Template path inside the module. |
| search | string | no | Fragment to replace. |
| replace | string | no | New fragment. |
| shop_id | integer | no | Shop ID in a multistore installation. Defaults to the shop in the connector address. IDs are listed by ps_get_shop_info. |
| confirm | boolean | no | false (default) returns a preview and saves nothing. true executes, only after the user approved the preview, together with change_token. |
| change_token | string | when: confirm=true | Token from the preview. Required with confirm=true. Valid 30 minutes, single use, bound to the previewed arguments and data state. |
Limits
After saving: ps_clear_cache.
What you see before anything is saved
Claude first calls the tool without confirming it. The module returns a preview (current and new values) and a single-use token valid for 30 minutes. Claude shows you the preview and saves the change only after your yes.
Related tools
- Write theme file ps_write_theme_file
- List modules ps_list_modules
- Restore file backup ps_restore_file_backup
- Clear cache ps_clear_cache
Last updated: 2026-10-03