=================
ABOUT THIS FOLDER
=================

This folder hosts your overrides to the default Zhong Framework views.

=============================
HOW TO ENABLE A VIEW OVERRIDE
=============================

	1. Enable the switcher
	----------------------

First of all, edit the file "zf/custom/overrides/application/ZhongFrameworkExtended.php", then search for the variable "$enable_views_overrides" and set it to "true". In other words, the line:

---> public $enable_views_overrides = false; <---

Must be changed into:

---> public $enable_views_overrides = true; <---


	2. Look for the php file of the view and copy/paste it into this directory
	--------------------------------------------------------------------------

For example, let's make an override of the view that prints the title and the subtitle: copy the file "zf/application/views/modules/site-titles.php", and paste it into the current folder "views-overrides".


	3. Make your changes!
	---------------------

Modify the php file as you like, for example, add a thrid subtitle to the code.


	4. Rename the file to target the method or the original php file
	----------------------------------------------------------------

The name of the modified file is used to target which view will be overridden. There are two special syntaxes for this. You can choose the one you like the most:

1st possible syntax
-------------------
The characters "/" of the path of the original php file (starting from the "zf/application/" folder) must be replaced by the character ">". In our example, the file must be renamed so:

"site-titles.php" ---to---> "views>modules>site-titles.php"


2nd possible syntax
-------------------
Open the file "zf/application/ZhongFramework.php", search which method is related to the php view, in our example is "views__modules__siteTitles". So the file must be renamed so:

"site-titles.php" ---to---> "views__modules__siteTitles.php"


	5. Check your website
	---------------------

Now the override should be active
