As in the previous recipe, you know that we have three different possibilities for extending CMS Made Simple and solving a problem: User-Defined Tag, Tags, and Modules. Deciding which of these is the best approach, however, requires additional knowledge about the strengths and weaknesses of each technique.
This recipe will help you examine your problem and consider whether creating a Tag is the most appropriate solution.
The criteria for deciding to use a Tag to extend CMS Made Simple are quite similar to the criteria for a User-Defined Tag.
To figure this out, consult the following list, and determine if each item applies to the problem you are trying to solve. Feel free to write down a list of your answers (yes/no).
1. Can your problem be solved with Smarty logic in your page template?
2. Are you trying to solve a problem that requires multiple actions? An example of multiple actions would be both displaying a form and processing its results.
3. Will you need to support localization and internationalization to solve your problem? For example, if your code will be displaying messages, will the messages need to be translated into multiple languages?
4. Will your solution require an Administration panel?
5. Do you need to create new database tables or set up new preferences to solve your problem?
If you answered "no" to all of the above questions, either a Tag or a User-Defined Tag would be a viable approach. To decide whether a Tag would be better than a UDT, consider the following questions:
1. Will you want to share this solution with other people so they can install it into their own CMS Made Simple sites, or will you want to reuse this code yourself on other sites?
2. Do you want your code to display help text in the Admin area, so site administrators understand what parameters are available and what the code does?
3. Will your solution serve as a Smarty modifier? A Smarty modifier is a function that reformats a variable for display, for example,
{$variable|uppercase}
where the modifier("uppercase")
serves to transform the variable ("$variable").
If you answer "yes" to any of these three questions, you should write a Tag instead of a User-Defined Tag.
A Tag is a way to connect a Smarty tag to some PHP code. The PHP code can do anything. Like in the case of User-Defined Tags, there are very few things that cannot be done in CMS Made Simple using Tags.
Because Tags are so versatile, the best way to determine if they are the ideal approach is by disqualification. We ask questions about the few things for which Tags are not ideal, to see if any of those things match our requirements. If none of them match, then the problem could be solved by either a Tag or a User-Defined Tag. To make the decision between those two approaches, we consider a few other criteria that will steer us in the right direction.
Let's consider the disqualifying questions again and examine why they would encourage us to use a different approach. The first five questions are the same as they were for User-Defined Tags.
Disqualifying Question |
If you answered "Yes" |
---|---|
Can the problem be solved simply using Smarty? |
If this is the case, we don't need to extend CMS Made Simple at all! For some great examples, please see Chapter 2, Programming with Smarty and Core Modules. |
Does your problem require multiple actions? |
It is, in fact, possible to handle multiple actions using a Tag, but the CMS Made Simple Module API has extensive support to simplify multiple actions, as well as conventions that will help keep the code separated nicely into maintainable chunks. Thus a Module would be a much better choice. |
Do you need localization or internationalization? |
These features could theoretically be implemented using a Tag, but there is no built-in support for either. The Module API, on the other hand, has facilities specifically to simplify those tasks. |
Will you need an Administration Panel? |
There is no easy way to implement an Administration panel in a Tag, while the Module API has numerous methods specifically for this purpose. |
Do you need to create database tables or preferences? |
You could write logic into your Tag to check on the existence and conditionally create database tables or preferences, but it would be easier to use the Module API which has specific support and standards for doing those operations. |
Now, let's consider the three things that differentiate a Tag from a User-Defined Tag:
Tag Qualifying Question |
If you answered "Yes" |
---|---|
Will you be sharing this solution with other people? |
A Tag is stored as a file on the server, which makes it easier to share with other CMS Made Simple users, since they can simply place the file in their own installation. A User-Defined Tag, on the other hand, is stored in the database, that adds extra steps if you want to share it. |
Do you want your code to display help text in the Admin area? |
The structure of a Tag has a special method for presenting information to the site administrator, while a User-Defined Tag has no such mechanism. |
Will your solution serve as a Smarty modifier? |
There are several kinds of Tags, including Smarty modifier tags. There is only one kind of User-Defined Tag, and it will not work as a Smarty modifier. |