Manual Installation Of Smf Modifications

[Andrew]

This tutorial will show you how to install mods for SMF on Zymic hosting.

The reason for this tutorial is because the package manager will not work in SMF on Zymic hosting, so to install any mods you will need to follow these directions.

Choose the mod that you want to install by browsing http://custom.simplemachines.org/mods/
Today I will be using the AddThis Social Bookmarks mod located: http://custom.simplemachines.org/mods/index.php?mod=1062

If you look on the mod page on the right hand side you will see where it says download, then just below it, it says, "Manual Install Instructions for SMF". Choose your SMF version from the dropdown box, and then click the "Parse" button.


You will be take to a page that looks like this:


On this page it's indicating that we only need to edit one file, ./Themes/default/Display.template.php other mods might have more than one file, but the basic layout of the edits we need to do is it will list the file, then list the line to find, then it'll say either "replace", "add before", or "add after".

On our mod we're working with right now it says for us to edit the file ./Themes/default/Display.template.php, so open that up by going to your smf folder, then opening the "themes" folder, then the "default" folder, then find the file named "Display.template.php" and open that with your favorite editor.

Our first step is to find

CODE

        </tr>';
    if (!empty($settings['display_who_viewing']))

and the next step tells us to add the bit of code "before" this line.

What I do is press ctrl+f in your text editor and find the line of code we need up there. We need to make sure it's exactly as shown above or else we can mess something up. I found this on line 211, but this may be different for you depending on how many mods you've installed.

Go ahead and copy the second bit of code:

CODE

                <!-- AddThis Bookmark Button BEGIN -->
        <td align="right" valign="middle" style="padding-right: 6px;">
             &lt;script language="JavaScript" type="text/javascript"><!-- // -->
            addthis_url    = location.href;  
            addthis_title  = document.title;  
            addthis_pub    = \'\';    
          // ]]></script>
          &lt;script type="text/javascript" src="http://s7.addthis.com/js/addthis_widget.php?v=12" ></script>
        </td>
        <!-- AddThis Bookmark Button END -->

And paste that in before the </tr>

You should end up having it look like this:

CODE

                <!-- AddThis Bookmark Button BEGIN -->
        <td align="right" valign="middle" style="padding-right: 6px;">
             &lt;script language="JavaScript" type="text/javascript"><!-- // -->
            addthis_url    = location.href;
            addthis_title  = document.title;
            addthis_pub    = \'\';
          // ]]></script>
          &lt;script type="text/javascript" src="http://s7.addthis.com/js/addthis_widget.php?v=12" ></script>
        </td>
        <!-- AddThis Bookmark Button END -->
        </tr>';
    if (!empty($settings['display_who_viewing']))

Now go ahead and save and upload that file over the old file. Your new mod should be in place and working now!
If you run into any troubles, check out the tutorial on SMF's website, http://docs.simplemachines.org/index.php?topic=402

The only reason I wrote this tutorial was because someone mentioned on the LiveChat that the tutorial on SMF's website wasn't that easy to understand.