Overview Xoops has a template engine that allows you to separate page generation (php code) from page layout and presentation (HTML + CSS). Xoops also supports a theme engine. This level of customization exists “above” data generation + layout and is outside the scope of this article. Templates are HTML documents written to make use of Smarty tags. Smarty is an additional language/layer that you must learn in order layout your Xoops generated HTML. Basically, though, the paradigm is one of adding in tags throughout your HTML that act as placeholders for incoming variables that were set up by the corresponding PHP page. By default, the search page for Xoops is found at the root of your Xoops directory and is called search.php. This page (unlike most) actually generates the HTML necessary to carry out it's assigned task directly inside the PHP code with a series of 'echo' statements. This makes the process of updating the look and feel of the Xoops search page more difficult since you now have to deal with the functionality of Xoop's search engine too. This 'How To' documents the process for stripping out layout from function with regards to search.php. At the end of this tutorial, your Xoops system will have a new system-level template that is associated with your search page. You'll be able to update the look and feel of your search page by manipulating this Smarty template rather than the search.php file directly. Furthermore, the search.php page will now have an interface (or contract) between itself and the corresponding template page that consists of various tags and their meanings. This means that you can tweak search.php whenever you like to change how the search engine works without necessarily affecting the look and feel of the search page itself (unless, of course, your changes necessitate a change to the interface with the template). Back Up Everything – Use a Test Site – Yadda, Yadda, Yadda As with anything, be sure to back up your valuable data first before attempting the changes in this document. Make these changes on test site first (if you can). Although nothing here is too invasive, it's important to be sure that you can recover if something goes wrong. searchform.php In the “include” folder, there exists a file called searchform.php. This file is responsible for generating the 'advanced search' form that you see at the bottom of every search page. Before we do anything else, we need to make a small change to this form in order to make it compatible with our new search template. At the very bottom of the file, simply add the following line: What does this do? Instead of the entire PHP page being included into “\search.php” (along with the creation and availability of it's $search_form variable), we treat the include like a function and 'return' the HTML version (produced by the render method) of the form that this file's code generates. modules/system/xoops_version.php Your next step is to tell Xoops about the Smarty template that you are about to create. You're probably already somewhat familiar with modules and how to install/configure them. Interestingly enough, Xoops treats it's system code like a module. This is why you see the “System Admin” button on the left side of Xoops' administration screen along with buttons for all of the other installed modules. It's because the system module is just that...a module! This is great because not only are you able to quickly and easily figure out how to configure the system in the same way that you'd configure a module, but the folks that wrote the Xoops core code are able to use the same bits of code for installing/updating system settings as they are for installing/updating modules. So what? Right? Well, the point of all this is that it is really easy to create a new template for the Xoops system. All you have to do is write the template (we'll do this later) and define that template for the Xoops system module. If you don't already know, you define templates for your modules in each module's 'xoops_version.php' file. This file contains lots of things in it that tell Xoops all about your module, not just template data. But the great thing is that, because of this architecture decision, it's really easy to define a new template. Simply add in this additional code somewhere around line 80: All we've done here is to define a 16th template. We've given it a file name, 'system_search.html' and a description which will show up whenever we try to edit our system templates. Create the Smarty Template Now it's time to really do something. Let's create the Smarty template for rendering our search page by creating a new file called '\modules\system\templates\system_search.html'. Please insert the following HTML/Smarty code into that new file that you just created: search.php The last major step involves updating the main search PHP page in the root of the Xoops system. Since the existing page generates all the HTML, we'll have to overhaul it so that places everything into Smarty template variables and passes those variables to the template we just created instead. So, edit your '\search.php' and make sure it looks like this: Update the System Module You've now placed all your shiny new code onto the site, but you won't see anything good yet until you do a couple of things first. First and foremost, you need to 'update' the system module so that your new Smarty template is loaded into the database. Follow these steps to do this: *) Goto the administration section on your website ('\admin.php'). *) Click the “System Admin” button on the left side of the screen. *) Click on “Modules”. *) Click the module update button for the system administration module () and confirm your selection. You should see the following text somewhere on the screen: Quote: Update the Default Template Set (optional) Hopefully, you are aware of the fact that you can define multiple template sets and select whichever one you'd like to be the 'default' template set for your web site. It would be really great if you could associate template sets with themes (hint, hint) ... but I digress. The point here, is that if you've decided to modify your templates to enhance the visual appearance of your web site (and if you are following these instructions, then that's a pretty safe assumption), you'll want to ensure that the new template we just made available is present in your default template set. Please following these instructions to do so: *) Goto the administration section on your website ('\admin.php'). *) Click the “System Admin” button on the left side of the screen. *) Click on “Templates”. *) In the Template Set Manager, find the row with a check mark in the far right column. This row is the currently selected template set for your site. *) Click the “List” link to the right of “System” in the Templates column of the Template Set Manager for the currently selected template set (boy that's a mouth full!). *) On the resulting page find the “system_search.html” row that is highlighted in yellow and click on the “Generate” link. This will ensure that this particular template set has your new search template ready for use. Conclusion That's it. Your new search page should be up and running (although you might have to clear out your template cache folder if you're still seeing the old one). You may now customize the look and feel of your site's search page by updating the appropriate template whenever you like. If you think this has been helpful, then please lobby the Xoops folks to have changes like this added to the core for the next version of Xoops. Author : rlankford from this thread