Inner Mod Menus
|In TNGv14, this mod has been absorbed into Mod Settings Blocks. This article is still the best documentation of the Inner Mod Menus feature.
Mods Settings Blocks now has a mod setting (in a Mod Settings Block, of course) that can disable Inner Mod Menus, which are enabled by default.
|Inner Mod Menus
|Provides PHP function libraries that display "Inner Mod Menus" and "New Tab Flags" that have been specified by other mods.
|15 Dec 2022
|(Retired in TNGv14)
|My Mod Support form
|My Mod Support form
|Min TNG V
|Max TNG V
genlib.php, genstyle.css, English, French, Norwegian cust_text.php; Installs rrinnermodmenu_lib.php, rrinnermodmenu_newtabs.php, rrinnermodmenu_wiki.gif
Many - see Related Mods
In TNGv12, the installed filenames are slightly different.
Purpose of the Mod
To enable the display of
- "Inner Mod Menus", which provides handy information about what a mod does to a particular program and handy access to the mod's options, and
- "New Tab Flags", which make it easy to see when new tab-menu tabs have been added by a mod, and to identify the mod that installed them.
that have been specified by other mods. It is not required by those other mods, however. If it is not installed, the menus and flags specified by the other mods are simply not visible.
Inner Mod Menus
An "Inner Mod Menu" is a drop-down menu that mods add to programs that they change in some arbitrarily "significant" way. The idea is to provide handy links to information about the mod and to the mod's options.
Here is an example of an Inner Mod Menu for a TNG page that is affected by three different mods, one of which has mod options in a Mod Settings Block. Inner Mod Menus drop down from the label "Mod Information" at the right end of the standard TNG "Inner Menu", which is the light-on-dark link menu immediately below the standard Tab Menu.
Significantly, Inner Mod Menus are visible only to TNG Administrators, even when they appear in end-user programs.
For each mod in an Inner Mod Menu, the menu can link to
- The mod's Wiki article,
- The section of the Wiki article that describes mod options,
- The mod's options, if the options are defined in a Mod Settings Block
- A popup that succinctly describes what the mod has changed in the program.
All but the first of these possible menu items are optional; the second and third only exist if the mod has options, and the fourth exists only if the mod programmer has created such a description.
The term "Inner Mod Menu" is defined at two levels,
- Mods are said to define an Inner Mod Menu when they call an Inner Mod Menu library function to specify any of the four Inner Mod Menu links listed above.
- If more than one mod defines an Inner Mod Menu in same page, all of those Inner Mod Menus will be presented in a multi-mod Inner Mod Menu on that page, as illustrated above
Long Inner Mod Menus
The Person Profile is modified by at least ten of the mods in my Regroup Person family of mods, and at least eight of them create Inner Mod Menus. That makes the Inner Mod Menu very long and hard to read. Consequently, mods define their Inner Mod Menus as "primary" or "secondary", and, when the program's Inner Mod Menu is first displayed, only the "primary" mods are listed, along with a link to "more mods", like this: [Show the Screenshot].
New Tab Flags
New Tab Flags do just what the name implies - they highlight the fact that a new tab has been created by a mod, and allow the user to see which mod installed the new tab. The flag is an asterisk, and the mod name is displayed when the user hovers over the asterisk, like this:
Mod Settings Blocks
The most important feature of Inner Mod Menus may be their ability to pop up a window containing a mod's settings to edit mod settings, thus giving site administrators the ability to change settings while the affected TNG program is still visible on the screen. After changing options, the administrator does not have to close the settings window, and can just refresh the TNG page to see how the new mod settings affect the page. Importantly, this can only be done with settings that are defined in "Mod Settings Blocks", which are enabled by the Mod Settings Block mod.
Mod Settings Blocks are more flexible and powerful than classic Mod Manager parameters. This screenshot illustrates a fairly typical Mod Settings Block that has been opened by itself, perhaps from an Inner Mod Menu link.
No known conflicts. Before Inner Mod Menus v184.108.40.206c, this mod was incompatible with Public Access Control.
Mod Settings Blocks is something of a sibling to Inner Mod Menus. Mod Settings Blocks define mod settings in a more robust and flexible way than standard Mod Manager parameters, and Inner Mod Menus supply handy links from TNG programs to the mod settings that affect program behavior.
More than 30 mods generate Inner Mod Menus in one or more of the pages that they modify. Again, the Inner Mod Menus mod is never required; if you do not install it, you simply will not be able to see any Inner Mod Menus or New Tab Flags. Here is a sample of mods that define Inner Mod Menus:
|admin_branches.php & admin_editbranches.php
|Admin Branches Queue
|Admin Cemeteries Search
|Admin Cemetery Edit
|Admin Media Search & Admin Media Predefined Search
|Admin Media Edit
|Admin Places Search
|Admin Places Geocode
|Cemetery Burials Table & Cemetery Map and Images
|headstones.php & showmap.php
|New Account Validation
|Regroup Person Profile, Regroup Person-Date Place
and upwards of 8 other Regroup Person* mods
- rrinnermodmenus_lib.php - The library that implements Inner Mod Menus
- rrinnermodmenus_newtab.php - The library that implements flags in new tab menu tabs.
- rrinnermodmenus_wiki.gif - A stylized "W" icon that is used in Inner Mod Menus as a link to a mod's Wiki article.
|A New Tab Flag
This screenshot is from admin_places.php, where two tabs are flagged with New Tab Flags the reveal that that the tabs were created by the Placename Format mod.
Note that the Inner Mod Menu in this screenshot does not mention the Placename Format mod, because Placename Format didn't modify admin_places.php in a sufficiently significant way. All Placename Format did to admin_places.php was to add the new tabs.
|This screenshot illustrates the Inner Mod Menu in the page that is launched from the "Name Options" tab in the previous screen clip. Here, the Placename Format mod is definitely significant, since it created the Name Options page. Thus, Placename Format has defined an Inner Mod Menu in this page. However, Placename Format does not define any mod options for the Name Options page, so the only links you see here are the always-present link to the Wiki article and a link that pops up information about what the mod has changed. (And since Placename Format installed this page, the "What has changed" link describes the entire page.
|Resolved a conflict with Public Access Control
|The "more" and "fewer" strings added in v220.127.116.11 were omitted from the English translations.
|Secondary mods are initially hidden from the Inner Mod Menu if the total number of mods is greater than 5.
Sites using this mod
If you download and install this mod, please add your site to the table below.
|Robin Richmond's Genealogy Database
|The Cole / Tanner Family Tree
|EN, DE, FR, ES, NL
|Public / Private
|NL, EN, ES
|R G Strong Family Genealogy
|EN, FR, DE, NL
|Huygens - Van de Moortel
|Public/Private on WordPress
|Your Roots are Showing
|Daniel Bender - Generations
|Public/ Living Private