TNG Mods: Addon Functionality: Rumsey Family Pages

rumseyfamilypages
genealogy of the rumsey and ballou families

You are currently anonymous - Log In

Home Search Search Print Print Login - User: anonymous Login

This modification allows for addons to easily integrate themselves onto the TNG public menus and admin menus, as well as provide code overrides, without having to make any edits to the original TNG files.

If you like this mod, be sure to check out my others here.

How To Use It - For Users

As a user, new addons are installed by simply unzipping the contents of the addon to your site (assuming the addon is using this mechanism. See below for a list of supported addons). However, this does not actually install the addon; for that you need to enable the addon from the Admin menu.

How To Use It - For Developers

Please visit the TNG Addon Mod for Developers for details about how to make your addon work within this infrastructure. As a developer of an addon, following this methodology allows for users to easily integrate your addons without having to modify their actual TNG files. There are several files and hooks that allow you integrate with TNG at various places.

addon_config.php: This file defines the addon, specifying information such as the name of the addon, version, author, etc. It also specifies all of the TNG functions that are modified as part of the addon. More details on the format of this file below.
override.php: All TNG functions that are overridden will be included in this file (regardless of which TNG file the function belongs to).
addon.js: Any javascript that should be loaded as part of your addon should be included here.

tabs_[type].php

innermenu_[page].php

menu_[type].php

admin_left.php
admin_right.php
admin_main.php

Shortcomings

As great as this method of managing addons for TNG may seem, it is not perfect. There are a few things you should be aware of while using this methodology:

Multiple addons that require edits to the same files pose a problem, as only one of the overridden files will actually get loaded.

Downloads

Instead of giving instructions on how to make these edits yourself, I am providing a zip file that contains all of the files required to implement the changes. If you don't have any addons already installed, you should be able to just upload the contents of the zip file to your site and be ready to go.

v 7.0.3

Modifications Required

Before attempting any edits on your TNG files, it is always a good idea to make a backup!

After uploading the contents of the zip file, the only modification required is a single line in your customconfig.php file.

@include($cms['tngpath'] . "addonsconfig.php");