glFusion Wiki

Site Tools


glFusion Tips & Tricks

This is a collection of tips and tricks from the glFusion forums. There is a forum dedicated to glFusion customizations and modifications, you should also look there for more ideas and options. Our goal with this page is not to re-create all the forum posts, but to consolidate some of the tips that came out of general support requests.

Template Customizations

glFusion allows you to customize the theme template (.thtml) and css files without actually modifying the original files. This allows you to make your customizations with confidence that they will not be overwritten during an upgrade. glFusion does this by including a folder named custom in every directory where there are .thtml or .css files. The template engine will first look in these custom directories for files, then in their regular locations, when building the page.

To customize a template or css file, first copy it into the custom folder in the same directory, then make your modifications to that newly copied file.

To customize a template or css file that resides in the directory:

private/plugins/<plugin_name>/templates/ copy the .thtml or .css file into its /custom folder, or to create a theme specific version of that plugin file, copy it into the



New with glFusion v1.1.3 is a config option to Include Template Comments in Page Source. When enabled, the {# and #} template comments will become <!– –> HTML comments and will be included in the output to the browser. Also, the beginning and end of each template, along with it's physical location on the server, will be included in the output. This feature is useful if you are trying to determine which template controls a specific display item, or when developing a new theme.

When you do upgrade your glFusion site, be sure and check the Template Changes page and make any necessary updates to your custom templates.

Language Customizations

We have created a new section in the wiki specifically on Language Customizations - please see this new section for more information.

Custom Read More

The goal of this tip is to replace the standard Read More link with a customized link that is included in the body of the story. We also want to make sure it does not display when the full article is displayed. Finally, we want to remove the extra line break between the intro text and the body text when displaying the full article.

We're going to use the to help accomplish this goal.

Go to the AutoTags admin screen, create a new autotag, let's call it more. Check the PHPfn box and save. Now we need to put the PHP function to drive this one in the private/system/lib-custom.php file (anywhere near the bottom before the ?>).

function phpautotag_more($p1, $p2, $fulltag)
    global $_CONF;

    $retval = '';
    $attr = array();

    $currentURL = COM_getCurrentURL();

    // if we are displaying the full article, simply return and do not replace the txt
    if ( strstr($currentURL,'article.php') ) {
        return $retval;
    if (!empty($p1)) {
        $url = $_CONF['site_url'].'/article.php?story='.trim($p1);
        $retval = COM_createLink( '>>>Keep Reading', $url, $attr );
    return $retval;

You can change the »>Keep Reading text to suit your needs.

Basically what this will do is only show the Keep Reading prompt when the article is shown on the main page. It will not show the link when viewing the full article.

Next, we want to make a few minor customizations to 2 templates:

  • featuredstorytext.thtml
  • storytext.thtml

We'll make the same changes to both. First, we want to take care of that extra space between the intro / body text. Look for this line:


We want to replace story_introtext with story_text_no_br. This will remove the extra line break between the intro and body text.

Next, we want to comment out the old standard Read more link, so look for:


Remove this line.

Now save both of these files in the layout/nouveau/custom/ directory, this way we don't overwrite the original and these changes will stay in place even after future upgrades.

That should do it, now edit your story and put your new [more:story_id] autotag in place and let's see if it works.

List Plugins in a new Block on Admin Home Page

By: Katwork

For whatever reason I have a hard time quickly finding the link I want on the Command & Control (Admin Home) page. When I go to the page I know that I want to access either a core glFusion item or a plugin so I figured it would be easier for me to find what I wanted if the plugins were displayed in a new block. It turned out to be really easy so I thought I'd share. Whether or not I did this correctly is another story, but it works for me.

For the full details (and updates) see the List plugins in a new block on the Admin Home page post in the glFusion support forums.

glfusion/tipstricks.txt · Last modified: 2017/01/18 09:45 (external edit)