View source for Media - Census Plus International

{{restricted}}{{V12_cust_text}}
{{TNGver
| ver = 9
|notes= The {{PAGENAME}} is a companion mod to the [[Census Plus International]] mod.  It was designed to process media attached to person events and will <span style="color: red">not work if you attach the census media to sources</span>.
}}              
{{TNGmod
| mod_name        = Media - Census Plus International
| mod_summary     = Displays the Census Feature transcript in showmedia.php for the census images that use TNG User media collections
| mod_validation  = 
| mod_last_update = 20 Jul 2019
| download_link   = <div style='overflow:none'>for {{Tv1210}}[http://www.royandboucher.com/ccount/click.php?id=499&user={{#replace:{{CURRENTLOGGEDUSER}}}}&page={{PAGENAMEE}} media-3_census_plus_v12.1.0.10a.zip]<hr />for {{Tv120}}[https://www.royandboucher.com/ccount/click.php?id=500&user={{#replace:{{CURRENTLOGGEDUSER}}}}&page={{PAGENAMEE}} media-3_census_plus_v12.0.0.10a.zip]<hr /></div>
<div class="mw-collapsible mw-collapsible-content" id="mw-customcollapsible-sb1"><span class="mw-customtoggle-sb1 mw-customtoggle-sbdiv" style='text-decoration:underline;float:right;'>&#91;Show older versions&#93;</span></div><br />
<div class='mw-collapsible mw-collapsible-content mw-collapsed' id="mw-customcollapsible-sbdiv">
<div style='overflow:none'>currently installed mod versions work with the new media_cpinclude.php provided in [[Census Plus International]]<hr /></div>
<div style='overflow:none'>for {{Tv1102}}[https://www.royandboucher.com/ccount/click.php?id=391&user={{#replace:{{CURRENTLOGGEDUSER}}}}&page={{PAGENAMEE}} media-3_census_plus_v11.0.2.6.zip] <br />supports renaming extensions folder<hr /></div>
<div style='overflow:none'>For {{Tv110}}{{Tv1012}} [https://www.royandboucher.com/ccount/click.php?id=382&user={{#replace:{{CURRENTLOGGEDUSER}}}}&page={{PAGENAMEE}} media-3_census_plus_v10.1.2.6.zip]<hr /></div>
<div style='overflow:none'>For {{Tv1010}} [http://www.royandboucher.com/ccount/click.php?id=425&user={{#replace:{{CURRENTLOGGEDUSER}}}}&page={{PAGENAMEE}} media-3_census_plus_v10.1.0.6.zip]<hr />For {{Tv1010}}<br /></div>
<div style='overflow:none'>[https://www.royandboucher.com/ccount/click.php?id=179&user={{#replace:{{CURRENTLOGGEDUSER}}}}&page={{PAGENAMEE}} Media-3_census_plus_v10.0.0.0a.zip]<hr /></div>
<div style='overflow:none'>{{Tv91}}[https://www.royandboucher.com/ccount/click.php?id=140&user={{#replace:{{CURRENTLOGGEDUSER}}}}&page={{PAGENAMEE}} media-3_census_plus_v9.1.0.4b.zip]</div>
<div class="mw-customtoggle-sb1 mw-customtoggle-sbdiv" style='text-decoration:underline;float:right;'>&#91;Hide old versions&#93;</div><br />
</div>
| download_stats  = [https://www.royandboucher.com/ccount/index.php?action=stats&id=217-372-382-391-438-425-472-497-498-499 View download statistics]
| mod_author      = [[User:Ken Roy|Ken Roy]]
| mod_url         = [[Media - Census Plus International]]
| mod_support     = [https://tng.community/index.php?/forums/ TNG Forums]
| mod_contact     = 
|  mod_version    = 12.1.0.10a for TNG v12.1+<br />12.0.0.10a for TNG v12 - 12.0.3<br />11.0.2.6 for TNG v11.0.2 and above provided in [[Census Plus International]]<br />10.1.2.6 for TNG v10.1.2 and above<br />10.1.0.3 for TNG v10.1<br />10.0.0.0a for TNG v10<br />9.1.0.4b for TNG v9.1 and above
| min_TNG_ver     = 9.1.0
| max_TNG_ver     = 12+
| TNG_file_list   = See [[Media - Census Plus International#TNG Modules Impacted|TNG Modules Impacted]]
| related_mods    =[[Census Plus International]]
| notes           = 
}}
{| style="margin-right:0.5 em;" align="right" 
| __TOC__
|}


== Purpose of the mod ==

This    mod displays the transcripts created by the [[Census Plus International]] mod below the census images that are part of TNG user media collections, rather than images saved in the census folder as dbid= file names or using your own file and folder names.

This mod '''only applies''' if you are using a TNG media collection for you census images.

It requires that you update the Image URL to point to a showmedia.php link for the census image.  See [[Census_Plus_International_-_Image#Media_Collection|Census Plus International - Image]]

== Developer ==

This mod was developed by [[User:Ken Roy|Ken Roy]] based on promptings by [[User:Ozigirl|Janice Nation]]

V9104 enhancement to display multiple households was developed based on promptings from [[User:Bsl20b50|Bryan S. Larson]] and [[User:lastejas|Rick Hooley]]

== Requirements ==

* A working TNG installation.
* A backup of all affected files (see the list in the summary in the upper right corner of the page)
* An installed current version of the [[Mod Manager]] (is already included in TNG v9)

* This mod further requires that you 
** install the [[Census Plus International]]
** use a TNG Media Collection to display your census images
** update the Image URL for the Census Transcript to point to a showmedia.php link for the Census Image
** Link the Census Image to the Individual census event for which you created links
**  If  you want to view more than one household in the transcript below  the  image, you also need to use the Mod Manager Edit on the Census Plus   International mod and changed the default for '''Return all linked  PersonIDs for Media transcript display''' regardless of household to  '''y'''

== Installation ==

#  Download the appropriate zip file as shown in the summary in the upper  right corner of the page. 
#   Extract the files and folder from the downloaded zip file into the  '''mods''' folder or FTP the extracted files and folder to your mods  folder.
#   Follow the normal automated installation for Mod  Manager, as shown in   the example [[Mod Manager - Installing Config  Files]] to install the   mod.
# Note - if you're using the tng.php  WordPress-TNG Plugin, you might need to '''"Update the TNG  Variables"''' in the WordPress Admin pane for the TNG Plugin to get this  to work correctly.

== Revision History ==

{| border="1" cellspacing="5" cellpadding="2" width="100%" class="wikitable"
|-
! Version
! Date
! Contents
|- valign="top"
| v12.1.0.10a<br />v12.0.0.10a
| 20 Jul 2019
| Updated to:
* fix censusYear ambiguous error if Return All Linked is set to default(n).  
* re-instate code from v12.0.0.9 on how Return All and Return all linked for Media options are processed
* fix 1890 US Veteran display works with Return all linked in showmedia.php transcript display
Requires Census Plus International v12.0.0.10a of mod
|- valign="top"
| v12.1.0.10<br />v12.0.0.10
| 11 Jul 2019
| Updated CP Veteran table to use milrank to support MySQL 8.  Requires Census Plus International v12.0.0.10 of mod
|-
| v12.1.0.9
| 24 Feb 2019
| Updated for TNG 12.1 
|-
| v12.0.0.8
| 23 Oct 2018
| Updated to match Census Plua International v12.0.0.8 and to user TNG v12+ cust_text.php guidelines
|-
| v12.0.0.7
| 1 May 2018
| Updated for TNG v12
|- valign="top"
| v11.0.2.6<br />v10.1.2.6<br />v10.1.0.6
| 31 March 2017
| Fixed the following
* Removed the household from the transcript display for the media Census Plus transcript display to display all households in that census image
* Synched mod versions with [[Census Plus International]]
|-
| v10.1.2.6
| 21 August 2016
| Updated to use $extspath for the extensions folder include
|-
| v10.1.2.5
| 21 May 2016
| Updated for TNG V10.1.2 and above to match the code used in [[Census Plus International]] v10.1.0.4 and v11.0.0.4
|-
| v10.1.2.4
| 7 July 2015
| Updated for TNG V10.1.2 
|-
| v10.1.0.3
| 12 January 2015
| Updated for TNG V10.1 new Mod Manager Syntax and to resolve the conflict with the [[ShowTable Mod]]
|-
| v10.0.0.0a
| 27 February 2014
| Updated for tablet and mobile mode display in TNG V10
|-
| v10.0.0.0
| 8 February 2014
| Updated for TNG V10
|- valign="top"
| v9.1.0.4b
| 30 Dec 2013
| The following fixes and changes were made in this update:
* added the Enumerated date to the Census Plus transcript reference display and added label tag formatting 
* updated to use Other Basic for the 1851 Census of Canada  
|- valign="top"
| v9.1.0.4a
| 14 Dec 2013
| The following fixes and changes were made in this update:
*   fixed the display of Enumeration District and page number for census   other than UK and US in the CP transcript include on the person page
|- valign="top"
| v9.1.0.4
| 9 Dec 2013
| The following fixes and changes were made in this update:
* include the same fixes to Census Plus transcript display as the [[Census Plus International]] mod
* fixed the code to display all linked persons in a transcript image if the [[Census Plus International - Options]] is set to y
|}

== Visualization of this mod ==
See [https://www.royandboucher.com/tng/showmedia.php?mediaID=315&medialinkID=527 Our Roy and Boucher Family]

With v9104 of the mod, you can now get mulitple households displayed in the Census Plus transcript displayed below the image, by enabling the Mod Manager Edit parameter in the [[Census Plus International]] mod for '''Return all linked PersonIDs for Media transcript display regardless of household'''.  This will then display all linked members to this image.

[[Image:Census_Plus_media_multiple_households.png|Multiple Household members]]

== Known Issues ==

After an import the Media link to the Person Census Event might get broken. The broken event link results in the Census Transcript not showing below the image display in showmedia.php.

If the census transcript is not displayed, Edit the media and make sure the media is linked to the census event for the person.  If the link only shows the link to the person and the event column is blank, then update the link and select the correct event to add to the link.

== Sites using this mod ==
If you download and install this mod, please add your TNG site to the table below:

{| border="0" cellspacing="1" cellpadding="2" class="wikitable"
|-
! URL
! User
! Note
! Mod-Version
! TNG-Version
! User-language
|-
| [https://www.royandboucher.com/tng/showmedia.php?mediaID=315&medialinkID=527 Our Roy and Boucher Family]
| [[User:Ken Roy|Ken Roy]]
| Worked with Janice Nation to develop this mod. Updated to support renaming the extensions folder
| 12.1.0.10a
| 12.1.0
| English, French
|-
| [https://www.ourfamilyhistories.org/showmedia.php?mediaID=257 Our Family Histories]
| [[User:Bsl20b50|Bryan S. Larson]]
| The included link shows a census image with 3 different families whose children later married.
| [[User:Bsl20b50|See Here]]
| [[User:Bsl20b50|See Here]]
| English
|-
| [http://paradiseohana.com/ Farnham &amp; Paradise Ohana]
| [[User:bfparadise|Barbara Paradise]]
| login: tngguest, pwd: tngguest
| 9.1.0.4b
| 9.2.2
| English
|}

== TNG Modules Impacted ==

The following TNG Modules are modified, and should be backed up prior to installing this mod:
* showmedia.php
* showmedialib.php
* languages/English/cust_text.php
* languages/English-UTF8/cust_text.php
The following module is added by this mod:
* extensions/media_census.php
*: which can be changed using the Mod Manaer Edit capability to specify the Media Collection IDs for this mod

== Related Links == 
{{:Census Plus International Related Links}}

[[Category:Mods for TNG v12]]
[[Category:Mods for TNG v11]]
[[Category:Mods for TNG v10]]
[[Category:Mods for TNG v9]]
[[Category:showmedia.php mods]]
[[Category:showmedialib.php mods]]
[[Category:cust_text.php English mods]]