Example: Categories on the homepage
Let's say you install a module that shows categories on your homepage. It probably comes with files like this:
/includes/modules/content/index/categories.php
/includes/modules/content/index/templates/tpl_categories.php
/includes/languages/english/modules/content/index/categories.php
You upload it and turn it on in Admin.
✔ Your homepage now shows categories. Done.
-------------------------------------------------------------------------------------
Want to tweak how it looks?
Start in Admin first:
Go to:
Admin → Modules → Content → Categories (Index)
Here you can change things like:
Sort order
Width
Background
Basic display options
✔ No code changes needed. Use this whenever possible.
-------------------------------------------------------------------------------------
Need something more custom?
This is where most systems go wrong - but not this one.
You do NOT edit the original files.
Instead, you use an override:
Copy:
```
/includes/modules/content/index/templates/tpl_categories.php
```
To:
```
/templates/override/includes/modules/content/index/tpl_categories.php
```
Now open your copied file and change it. For example:
```
<h1>TEST 123</h1>
```
Reload your homepage…
✔ You’ll see your change.
-------------------------------------------------------------------------------------
Why this matters
You never touch the original files
Your changes survive updates
You can always undo or remove your customisation
The system stays clean and upgrade-safe
-------------------------------------------------------------------------------------
It does take a little time to understand how Phoenix works - especially things like templates, hooks, and modules.
But once you've got the basics, everything becomes much easier to manage.
Instead of fighting the system, you work
with it:
- You can change how things look without breaking the core
- You can add features using modules, not hacks
- You can update safely without losing your work
- You stay in control of your store
A learning curve is needed, but the payoff is long-term stability and flexibility.
In practical terms: once you "get it," running and evolving your store becomes far simpler - and far less risky.