Showfolio Admin Mod

Showfolio Admin
Summary	Control file maintenance for the Showfolio Mod.
Validation
Mod Updated	see Revision History
Download link	version 14.0.0.16.zip TNG 14.0 version 13.0.0.8.zip TNG 13.0 version 11.0.0.6.zip TNG 11.0 version 10.1.1.1.zip TNG 10.0
Download stats	View Stats
Author(s)	Rick Bisbee
Homepage	Bisbee Family Connection
Mod Support	Support for Showfolio_Admin_Mod
Contact Developer	As above
Latest Mod	14.0.0.16
Min TNG V	10.0
Max TNG V	14+
Files modified	customconfig.php, admin_leftbanner.php, admin_main.php
Related Mods	Showfolio_Mod Media_Icons_Mod
Notes

Introduction

This is a companion to the Showfolio Mod. It adds a panel to the TNG admin page to create or edit Folios. If creating a folio it will register it as media in the TNG database.

This mod now registers a folio in the TNG database and can switch to the TNG media editor to add more Folio options and associate it with a person or event.

Mod was developed by Rick Bisbee based on original work and design by Martin Pannier.

Compatibility

Showfolio Admin Mod Tested With following TNG Versions

Version	1000 all	1100 all	1200 all	1300 all	1400 all
10.1.1.1
11.0.0.6			PHP 5.6/7.2
13.0.0.8				PHP 5.6/7.4/8.1
14.0.0.16					PHP 7.4/8.2

*green: compatible   red: not compatible   white: not tested

See Multisite Testbed for information on how this mod is tested and managed.

Revisions

Version	Date Released	Showfolio — What's New
14.0.0.16	8 JUl 2023	Magnifier (showmagnifier) is no longer a selectable option - user selects while on page Bug fix - inconsistent handling of collection folder path sometimes led to using bad path
14.0.0.15	22 JUN 2023	Bug fix - filter filenames out of directory list (fatal error)
14.0.0.14	27 FEB 2023	Bug fix refrerence tng_real_escape_string()
14.0.0.13	21 FEB 2023	Removes long temporary database interface for MySQLi and now uses the standard TNG database interface (tngconnect.php) Improves the search algorithm to find more folios Admin_showfolio mod v14.0.0.12 was not released
14.0.0.11	11 FEB 2023	Fixes problem creating a correct database record.
14.0.0.10	11 FEB 2023	Updates the folio search algorithm. Last element in the search path can be completely ambiguous to find paths containing that string inside that path element (see example below)
14.0.0.9	28 Dec 2022	Initial update for TNGv14
13.0.0.8	26 Dec 2021	Fixed bug that prevented searching for folios in native TNG collection folders Verified compatibility with PHP 8.1
13.0.0.7 11.0.0.6	9 Nov 2020	Fixed minor bugs Fixed a bug that prevented creation of a Filio in a Standard TNG collection folder. Simplified steps to create a Folio
13.0.0.5	21 Sep 2020	Totally updated to work with TNGv13 New features make it more convenient to use
11.0.0.4	9 Apr 2019	Added Dutch-UTF8 language support courtesy of Daniel Aelbrecht Fixes language files copy probem

TNG Admin Panel

New option added to TNG admin page

Select Folio

Search collection and/or subfolder to edit existing Folio, or add Title to create and register a new one

Ambiguous Folio Name

The last element in the search path can be ambiguous. Using an example from my own site:

In this example, "geo" is ambiguous, that is, can match several folio paths.

If the folio path or name is ambiguous, you will be presented with a list of all matching folios to choose from for editing.

Create/Edit Control File

Each Folio folder contains a control file -- folio.php -- which contains options for displaying Folio pages and also acts as the "media" file in the TNG database.

An index.php file can be added to the folder to redirect visitors to the correct URL to view the Folio.

Admin_showfolio will create both files for you as well as register the folio in the database.

The edit page lets you select options and actions.

Edit/view the control file to change and save local options, or Edit Folio in TNG

A word about the tab map. You can map tabs to folio pages using a string (no quotes). For example

Cover, Info, [1-350],Index,[352-394]

Numbers inside square brackets represent a range. Above, the first page tab is labeled "Cover", the second is "Info" followed by pages numbered 1 to 350, then "Index", followed by tabs (pages) 352 to 394.

Tab labels are not bound to the actual page content. If you use a numbering scheme like the one shown above, you will have to modify it if you add or remove a page from the folder to keep the tabs "synced".

Control File

Folio.php is created by the Showfolio Admin mod.

Index File

Index.php is created by the Showfolio Admin mod to redirect visitor to the Folio.

Disclaimer

As always, there is no warranty. Use this mod at your own risk.

TNG Sites using this mod

If you download and install this mod, please add your TNG site to the table below so we will know if it is worth maintaining.

URL	User	Note	TNG-Version	Mod-Version	User-language
Bisbee Family Connection	Rick Bisbee	Easiest way to create and maintain Folios	14.0.1	14.0.0.10	EN
A Line of Malkins' in New Zealand - Nu Tirani	Rick Malkin	Excellent companion Mod to the ShowFolio Mod	14.0.2	14.0.0.16	EN
William Ernest Moffat World War One Service Record	Roger Moffat	Great way to create and maintain Folios	14.0.1	14.0.0.10	EN
Clan Moffat Genealogy Online	Roger Moffat	Fantastic way to create and maintain Folios	14.0.1	14.0.0.10	EN