Private Media Mod

From TNG_Wiki
Jump to: navigation, search
Private Media Mod
Summary This allows media - documents, photos etc. - to be declared private and allows the administrator to decide which users can see them.
Validation The mod is XHTML compliant.Valid-xhtml10.png
Download link 11.1.1.5c for
TNG 11.1.1

10.0.3.4f for
TNG 10.0.3
Download stats Downloads
Author(s) Chris Moss
Homepage Private Media Mod
Mod Support contact author
Contact Developer contact author
Latest Mod 0
Min TNG V 10.0.3
Max TNG V 11.1
Files modified
see category list at the foot of the page. Also cust_text.php for English, German and Norwegian.
Related Mods
Notes


TNG allows people to be declared private, and protects media for living people (together with all documents) with several options, but you may want to restrict other items on the internet. Documents in particular can be sensitive. There may be copyright involved or agreements with relatives on who can see them. Reproduction of quality photos to the world may similarly be impossible. Often too there are intimate family documents or photos that people don't want on the open web.

The net effect of this is often to "lock down" the website and prevent others from viewing genealogy information that would otherwise be displayed.

So the mod provides "Private" tags for media (photos, documents, headstones, histories etc) and albums, which when activated keep them from the public eye. It also provides an extra permission for registered users, to allow them to read private media.

TNG does already protect media associated with living people, but this is the only form of protection.

Note: the option to make reports private in the first version of this mod has been removed because the same functionality is achieved by not making a report active.

Please note: If you've upgraded to 11.1.1 you will need the new version (5).

Installation

  1. Download the file from the download links in the mod summary area in the upper right.
  2. Extract the downloaded zip file to your 'mods folder.
  3. Open the Mod Manager and you will find a note that says:
    Important: Before you install this mod for the first time, you must change the database by clicking here.
    Clicking on the link will activate a small program that allows you to add the necessary fields to the database. Once you've added them you can forget about this program. You shouldn't need to change these again if you remove, reinstall or update the mod. If you do remove them, any setting you have made with the mod will be permanently forgotten. There is little if any overhead involved in having these fields in the database.
    Follow the instructions.
  4. Now follow the installation procedure for Mod Manager, as shown in the example Mod Manager - Installing Config Files to install the appropriate Private Media Mod.cfg file.
  5. Whilst within the administration area, go to "Users" and give yourself privileges to read private media. In the table this is represented (in English) as PMedia. Do the same for all users you want to be able to access them.
  6. Finally it is important that you handle the "thispagedoesnotexist" error correctly. This is triggered by many modules. For example, if a user is inspecting a photo (showmedia) and logs out, then if you don't have this page, the screen will just go blank, which isn't very professional. The answer is to customise the page or install the Person Not Found Mod.

Post Installation

You will need to go round your site and make private any items that shouldn't be public and load up those files which you haven't previously put on the site for any reason connected with visibility. It may also be that you can relax some of the privacy constraints that you had to impose because these privacies were not possible.

Caution: if you decide after installation that you definitely don't want to use this mod, then you are advised to go through the procedure for changing the database again and remove the changes it makes. The reason is that it may make some other code invalid: the one known instance is in the "most wanted" area, but others may occur in future.

Options

With v4f and 5b it is possible to set the private option by default for creating new media and albums. When you have installed the mod, click on Installed [Options] and then Edit Options and put 1 in the option box and press Update. This will be remembered if you uninstall and reinstall the mod. You can still override this option when creating a new media or album item.

Mod Compatibility issues

Because of the large number of files affected by this mod, it hasn't yet been possible to check all the possible conflicts. The following modules have given problems and updates are in some cases being prepared so you might need to update them:

TNG User sites using this mod

If you download and install this mod, please add your TNG sites to the table below.

URL User Note Mod-Version/TNG-Version User-language
Your Roots are Showing Harold Craswell Template 12 10.0.3.2/10.1.1 EN
Moss Family Tree Chris Moss Template 5 10.0.3.2/10.1.1 EN, FR, DE
Wonson Genealogy Mark Wonson Template 5 10.0.3.4a/11.0.1 EN
MOTYER Family Genealogy John Mark Motyer Template 2 see here EN, DE, RU
From Tea to Tumbleweeds Trudy Lusk Template 8 10.0.3.4b/11.0.1 English
Racine d'Alsace J-Louis Valory Public/Private - Template 1 11.1.1.5a/11.1.1 French
Family Histories Steven Davis Public/Private - No Template 11.1.1.5b/11.1.1 English

Revision History

Version Date Contents
11.1.1.5c 2 Sep 2017 correct problem when adding new users
11.1.1.5b / 10.0.3.4f 2 July 2017 allow private as default and correct bugs in 11.1.1 admin_addmedia.php and admin_addalbum.php
11.1.1.5a / 10.0.3.4d 11 June 2017 change anchor in cust_text files
11.1.1.5 6 June 2017 Updated for TNG 11.1.1
10.0.3.4c 4 Jun 2017 corrected a problem in What's New-files didn't show when logged in ok
10.0.3.4b 11 Aug 2016 corrected a problem with setting users rights to trees
10.0.3.4a 5 July 2016 Added an exclusion for headstones.php which showed thumbnails
10.0.3.3 9 Apr 2016 Internal changes: reduce search terms in cfg file to avoid several v11 revisions to existing code
10.0.3.2 25 Jun 2015 Corrects a problem with most wanted (thanks Harold). Note this has been tested on both 10.0.3 and 10.1.1 so keeps the earlier number.
10.0.3.1 20 May 2015 Corrects a problem with the database installation; removes private reports; puts admin strings in cust_text.php rather than admintext.php.