Difference between revisions of "Private Media Mod"

From TNG_Wiki
Jump to navigation Jump to search
(→‎Revision History: mods for v12)
(updated Support Needed message)
 
(28 intermediate revisions by 11 users not shown)
Line 1: Line 1:
{{TNGmod
+
{{SupportNeeded
 +
|notes=I have posted the [[Enable Allow Private Media]] mod which enables the Allow Private Media privilege to the Users record and will be a pre-req for this mod. I have started reworking the [[Private Media Mod]] and am working with [[User:Mark|Mark Wonson]] and [[User:MichelKirsch|Michel Kirsch]] to update the mod to use the new Allow Private Media privilege added to the tng_users record in TNG v14, with the hope that we can get Darrin to make this part of TNG. <br /> [[User:KenRoy|KenRoy]] ([[User talk:KenRoy|talk]]) 13:30, 13 October 2023 (CDT)}}{{TNGmod
 
| mod_name        = Private Media Mod
 
| mod_name        = Private Media Mod
 
| mod_summary    = This allows media - documents, photos etc. - to be declared private and allows the administrator to decide which users can see them.  
 
| mod_summary    = This allows media - documents, photos etc. - to be declared private and allows the administrator to decide which users can see them.  
 
| mod_validation  = The mod is XHTML compliant.[[Image:Valid-xhtml10.png|44px]]
 
| mod_validation  = The mod is XHTML compliant.[[Image:Valid-xhtml10.png|44px]]
| mod_last_update = 5 Feb 2018
+
| mod_last_update = 23 May 2020
| download_link  =  [http://mossfamilytree.info/download.php?mod=private_media_mod&version=12.0.0.6a 12.0.0.6a] for {{Tv120}} <hr />[http://mossfamilytree.info/download.php?mod=private_media_mod&version=11.1.1.6 11.1.1.6] for {{Tv1111}} <hr />[http://mossfamilytree.info/download.php?mod=private_media_mod&version=10.0.3.5 10.0.3.5] for {{Tv1003}}
+
| download_link  =  [http://mossfamilytree.info/download.php?mod=private_media_mod&version=12.1.0.8b 12.1.0.8b] for {{Tv1210}} <hr />[http://mossfamilytree.info/download.php?mod=private_media_mod&version=11.1.1.8 11.1.1.8] for {{Tv1111}} <hr />[http://mossfamilytree.info/download.php?mod=private_media_mod&version=10.0.3.8 10.0.3.8] for {{Tv1003}}
 
| download_stats = [http://mossfamilytree.info/downloadstats.php?mod=private_media_mod Downloads]
 
| download_stats = [http://mossfamilytree.info/downloadstats.php?mod=private_media_mod Downloads]
 
| mod_author      = [[User:Chris Moss|Chris Moss]]
 
| mod_author      = [[User:Chris Moss|Chris Moss]]
Line 12: Line 13:
 
| mod_version    = 0
 
| mod_version    = 0
 
| min_TNG_ver    = 10.0.3
 
| min_TNG_ver    = 10.0.3
| max_TNG_ver    = 11.1
+
| max_TNG_ver    = 12.2
 
| TNG_file_list  = see category list at the foot of the page. Also cust_text.php for English, German and Norwegian.
 
| TNG_file_list  = see category list at the foot of the page. Also cust_text.php for English, German and Norwegian.
 
| related_mods    =  
 
| related_mods    =  
Line 58: Line 59:
 
*[[AccessRestriction]] needs v10.0.3.2 to work correctly
 
*[[AccessRestriction]] needs v10.0.3.2 to work correctly
 
*[[Admin Media Search]] needs v10.1.0.7b to work correctly
 
*[[Admin Media Search]] needs v10.1.0.7b to work correctly
*[[Compact Person Media]]  
+
*[[Compact Person Media]] (which doesn't work in TNG 12)
 +
*[[Person Media Title]] You need to install Private Media ''before'' installing Person Media Title
  
 
== TNG User sites using this mod ==
 
== TNG User sites using this mod ==
Line 71: Line 73:
 
! Mod-Version/TNG-Version
 
! Mod-Version/TNG-Version
 
! User-language
 
! User-language
|-
 
| [http://craswell.ca Your Roots are Showing]
 
| [[User:crashar|Harold Craswell]]
 
| Template 12
 
| 10.0.3.2/10.1.1
 
| EN
 
 
|-
 
|-
 
| [http://mossfamilytree.info Moss Family Tree]
 
| [http://mossfamilytree.info Moss Family Tree]
Line 89: Line 85:
 
| 10.0.3.4a/11.0.1
 
| 10.0.3.4a/11.0.1
 
| EN
 
| EN
|-
 
| [https://genealogywings.com/ MOTYER Family Genealogy]
 
| [[User:JMM|John Mark Motyer]]
 
| Template 2
 
| [[User:JMM|see here]]
 
| EN, DE, RU
 
 
|-
 
|-
 
| [http://www.tea2weeds.com/ From Tea to Tumbleweeds]
 
| [http://www.tea2weeds.com/ From Tea to Tumbleweeds]
Line 101: Line 91:
 
| 10.0.3.4b/11.0.1
 
| 10.0.3.4b/11.0.1
 
| English
 
| English
|-
 
| [http://racine-ad.fr/TNG/index.php Racine d'Alsace]
 
| J-Louis Valory
 
| Public/Private - Template 1
 
| 11.1.1.5a/11.1.1
 
| French
 
 
|-
 
|-
 
| [http://familyhistories.us/ Family Histories]
 
| [http://familyhistories.us/ Family Histories]
 
| Steven Davis
 
| Steven Davis
 
| Public/Private - No Template
 
| Public/Private - No Template
| 11.1.1.5b/11.1.2
+
| 12.1.0.8b/12.3
 
| English
 
| English
 
|-
 
|-
Line 117: Line 101:
 
| Mogens C. Fenger
 
| Mogens C. Fenger
 
| Private - Template 15
 
| Private - Template 15
| 11.1.1.5c/11.1.2
+
| 11.1.1.6 / TNG 12.0..1
| Danish, English
+
| DA, EN
 +
|-
 +
| [https://www.gambrillfamilytree.com/ Gambrill Ancestry]
 +
| Bobby Gambrill
 +
| Public - Template 15
 +
| 12.0.0.6a / TNG 12.0.2
 +
| EN
 +
|-
 +
| [http://www.colegenealogy.net/ The Cole / Tanner Family Tree]
 +
| [[User:dlcole|David Cole]]
 +
| Public/Private
 +
| [[User:Dlcole|see here]]
 +
| EN, DE, FR, ES, NL
 
|-
 
|-
 
|}
 
|}
Line 129: Line 125:
 
! Date
 
! Date
 
! Contents
 
! Contents
 +
|-
 +
| 12.1.0.8b
 +
| 23 Jul 2020
 +
| add protection to rpt_utils.php for generated PDF files. Also recorrect installation. See note below. Thanks to [[user:Steve1200|Steven Davis]] for finding this.
 +
|-
 +
| 12.1.0.8a
 +
| 13 Jun 2020
 +
| correct installation problem
 +
|-
 +
| 12.1.0.8 /11.1.1.8 /10.0.3.8
 +
| 23 May 2020
 +
| add protection to getPhotoSrc in pedbox.php which fixes descend.php, relationship.php and pedigree.php (thanks to [[user:Steve1200|Steven Davis]] for pointing this out).
 +
|-
 +
| 12.1.0.7b
 +
| 23 Apr 2019
 +
| change mods to $modspath in descriptor to allow for different mods/ directory
 +
|-
 +
| 12.1.0.7a
 +
| 13 Apr 2019
 +
| changes to personlib and admin_adduser. Also supports admin_photoimport.php and admin_photoimporter.php
 
|-
 
|-
 
| 12.0.0.6a  
 
| 12.0.0.6a  
Line 178: Line 194:
 
| Corrects a problem with the database installation; removes private reports; puts admin strings in cust_text.php rather than admintext.php.  
 
| Corrects a problem with the database installation; removes private reports; puts admin strings in cust_text.php rather than admintext.php.  
 
|}
 
|}
 +
 +
'''Note''': v8 and 8a of the mod had a tricky problem to do with the modification to add_user.php. When the mod is uninstalled there are two places where it still thinks it's installed. Just ignore this message and install 8b. There's a sequence $template = "ssssssssssssssssssssssssssssssssss in the edit to line 70 where there are 33 s's instead of the correct 34 (this was 26 in v8). The same applies to a list starting ?,?, in the edit to line 72. These occurred because the 12.1 update to add_user.php which added an extra parameter dt_consented 3 from the end had not been carried out. Apologies for this. Do contact me if you're having difficulty with it.
  
 
[[Category: Mods for TNG v12]]
 
[[Category: Mods for TNG v12]]

Latest revision as of 13:30, 13 October 2023

NeedSupport I have posted the Enable Allow Private Media mod which enables the Allow Private Media privilege to the Users record and will be a pre-req for this mod. I have started reworking the Private Media Mod and am working with Mark Wonson and Michel Kirsch to update the mod to use the new Allow Private Media privilege added to the tng_users record in TNG v14, with the hope that we can get Darrin to make this part of TNG.
KenRoy (talk) 13:30, 13 October 2023 (CDT)
NeedSupport


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
Mod Updated 23 May 2020
Download link 12.1.0.8b for
TNG 12.1.0

11.1.1.8 for
TNG 11.1.1

10.0.3.8 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 12.2
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
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
From Tea to Tumbleweeds Trudy Lusk Template 8 10.0.3.4b/11.0.1 English
Family Histories Steven Davis Public/Private - No Template 12.1.0.8b/12.3 English
Nordic Ancestry Mogens C. Fenger Private - Template 15 11.1.1.6 / TNG 12.0..1 DA, EN
Gambrill Ancestry Bobby Gambrill Public - Template 15 12.0.0.6a / TNG 12.0.2 EN
The Cole / Tanner Family Tree David Cole Public/Private see here EN, DE, FR, ES, NL

Revision History

Version Date Contents
12.1.0.8b 23 Jul 2020 add protection to rpt_utils.php for generated PDF files. Also recorrect installation. See note below. Thanks to Steven Davis for finding this.
12.1.0.8a 13 Jun 2020 correct installation problem
12.1.0.8 /11.1.1.8 /10.0.3.8 23 May 2020 add protection to getPhotoSrc in pedbox.php which fixes descend.php, relationship.php and pedigree.php (thanks to Steven Davis for pointing this out).
12.1.0.7b 23 Apr 2019 change mods to $modspath in descriptor to allow for different mods/ directory
12.1.0.7a 13 Apr 2019 changes to personlib and admin_adduser. Also supports admin_photoimport.php and admin_photoimporter.php
12.0.0.6a 14 May 2018 couple of changes for v12. This is still compatible with the v11.1.1 version. Thanks, Gero.
11.1.1.6 / 10.0.3. 5 Feb 2018 change installation instructions to make database change option clearer
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.

Note: v8 and 8a of the mod had a tricky problem to do with the modification to add_user.php. When the mod is uninstalled there are two places where it still thinks it's installed. Just ignore this message and install 8b. There's a sequence $template = "ssssssssssssssssssssssssssssssssss in the edit to line 70 where there are 33 s's instead of the correct 34 (this was 26 in v8). The same applies to a list starting ?,?, in the edit to line 72. These occurred because the 12.1 update to add_user.php which added an extra parameter dt_consented 3 from the end had not been carried out. Apologies for this. Do contact me if you're having difficulty with it.