Help: Media

Manage

This tab allows you to locate existing media, then edit or delete them.

Search for
Enter a keyword (or part of a word) matching all or part of the following fields: Media ID, Title, Description, Path, Owner, or Body Text (Histories). A cookie will store the value entered here for future searches. Click the Search button to execute the search. Click the Reset button to blank out the field. If the Search button is clicked with no search criteria, all media records will be returned.

Tree
Select a tree from this dropdown box prior to clicking the Search button to restrict the results to media assigned to the selected tree.

Collection
Select a collection from this list prior to clicking the Search button to restrict the results to media of the selected type.

File ext.
Enter a file extension (e.g., "jpg" or "gif") prior to clicking the Search button to restrict the results to media with file names matching that extension.

Unlinked only
Check this box prior to clicking the Search button to restrict the results to media that are not linked to any individuals, families, sources, repositories or places.

Status (visible for Headstones only)
Select a status from this list prior to clicking the Search button to show all headstone records with the same status.

Cemetery (visible for Headstones only)
Select a cemetery from this list prior to clicking the Search button to show all headstones assigned to the selected cemetery.

Edit/Delete/Test
Click on the appropriate icon in the Action column to edit, delete or test (preview) the media record listed on that row.



Add New / Modify Existing Media

To add a new media item, click on the Add New tab, then fill out the form. To edit an existing media item, click on the Manage tab, then locate the item using the Search utility and click the Edit icon next to that item.

Fields available on both the Add New Media and Modify Existing Media screens include:

Collection
Choose what type of media your item is (e.g., Photos, Documents, Headstones, Histories, Recordings or Videos). There is no restriction on file type for any of these media "collections".

Media File
Select a physical file (either from your local computer or from your web site) for this media item.

File to Upload
If your new media item has not yet been uploaded to your web site, click Browse and locate it on your hard drive. If the item is already on your site, leave this field blank.

File name on site
If you had previously uploaded your media item, enter the path and file name of your item as it exists within the corresonding collection folder on your web site. If you don't know the exact file name, you can click on the Select button to locate the file. If you are uploading your media item now using the previous field, use this box to enter a path and file name for your file after it is uploaded. A suggested path and file name will be prepopulated for you. NOTE: If you are uploading now, the directory you indicate here must already exist and must be writeable by all. If not, use your FTP program or online file manager to create the directory and give it proper rights (775 should work, but 777 is required on some sites).

If you would like to link to an external image, enter the absolute path (for example, "http://www.thatsite.com/image.jpg") in this field and leave "File to Upload" blank. See below for more details on this option.

OR Body text (Histories only)
Instead of uploading a physical file for your history, you can type or paste the text or HTML code into this box. If you are using HTML, do not include the HTML or BODY tags.

Convert line breaks to HTML on display
Check this box to have TNG convert line breaks entered in the "Body text" box to HTML line breaks. Leaving this box unchecked will result in line breaks being ignored. HTML line breaks entered in the box will always be respected.

Thumbnail Image File
Select a physical file (either from your local computer or from your web site) to act as a "thumbnail" (smaller image) for this media item (optional). Notes: Ideally, thumbnails should be between 50 and 100 pixels on a side. Your thumbnail CANNOT be the same as the original image! TNG will complain if you attempt to use the original image as the thumbnail. TNG can only create a thumbnail for you if your media item is a valid JPG, GIF or PNG image.

Specify image/Create from original
If your server supports the GD image library, you will see an option here to supply your own thumbnail or to have TNG create it for you from the original. If you choose the latter, by default the name of the new file will be the same as the original, with a prefix and/or suffix attached. This prefix and suffix, along with the max width and height of the thumbnail, are designated in the General Settings. Notes: Your thumbnail CANNOT be the same as the original image! TNG will complain if you attempt to use the original image as the thumbnail. TNG can only create a thumbnail for you if your media item is a valid JPG, GIF or PNG image. PHP may complain if you ask to have a thumbnail created for an image that is very large (more than a Mb or so).

File to Upload
When an individual's genealogy is requested, thumbnail images of each photo linked to the individual are displayed on the same page. If a thumbnail image for your media item has not yet been uploaded to your web site, click Browse and locate the thumbnail on your hard drive. You must then enter the destination path and file name for the thumbnail image in the next field. If the thumbnail is already on your web site, leave this field blank.

File name on site
If you had previously uploaded your thumbnail image, enter the path and file name of your thumbnail as it exists within the corresponding collection folder on your web site (hint: you could put thumbnails in a subfolder if you want them to be kept separate or have the same names as the larger images). If you don't know the exact file name, you can click on the Select button to locate the file. If you are uploading your thumbnail now using the previous field, use this box to enter a path and file name for your thumbnail after it is uploaded. A suggested path and file name will be prepopulated for you. NOTE: If you are uploading now, the directory you indicate here must already exist and must be writeable by all. If not, use your FTP program to create the directory and give it proper rights (775 should work, but 777 is required on some sites).

Store files in: Multimedia Folder / Collection Folder
You may choose to store this media item in a folder corresponding to the collection selected above (the default option), or you can put it in the general Multimedia folder.

Title
This should be short — just a few words to identify your media item. It will be used as a link to the page displaying your item.

Description
Include more detail here if necessary, including information about who or what is pictured or described, etc. This will be displayed as a blurb accompanying your short description link (see previous field).

Width, Height (Videos only)
Some video players (e.g., Quicktime) require that the width and height of the video be specified. If these are not specified, then the video may be cropped too tightly and some portions of the video will not be visible. It is therefore recommended that you enter the size of your video here in pixels. Please also remember to leave about 16 vertical pixels for the video controller (the play/stop/volume controls, etc.).

Owner/Source, Date Taken, Place Taken
These are optional freeform fields. If you know this information, enter it in the appropriate areas.

Latitude, Longitude
If there are latitude and/or longitude coordinates associated with your media item, enter them here to help others more accurately pinpoint the location.

Tree
If you would like to associate this media item with a particular tree, select that tree here. This will affect users who only have permissions to edit items associated with their assigned tree.

Status (Headstones only)
Select from the dropdown list the word or phrase that best describes the condition of the headstone in question.

Cemetery (Headstones only)
Select from the dropdown list the cemetery where the headstone is located. You must first add the cemetery (under Admin/Cemeteries) before it will be visible in this box.

Always viewable
Check this box if you want this media item to be displayed for the linked individuals at all times, regardless of their living status and user permissions.

Open in new window
To cause the item to open in a new window when its link is clicked, check this box.

This media comes from an external source
Check this box if this image resides somewhere on the Internet other than on your server. You must supply an absolute path (for example, "http://www.thatsite.com/image.jpg") in the field labeled "File name on site" (leave the "File to Upload" field blank), and you must provide your own thumbnail if you wish to have one (TNG will not create one).

Link this media directly to the selected cemetery (Headstones only)
Check this box to associate this headstone image with the cemetery itself. When the cemetery page is displayed, any media items associated with the cemetery in this manner will be displayed at the top of the page.

Show cemetery map and media whenever this item is displayed (Headstones only)
If the cemetery where this headstone is located has an accompanying map or photo, check this box to display the map or photo as well whenever the headstone is displayed.

Link to:
Link this media item to individuals, families, sources, repositories or places. For each link, first select the tree associated with the link entity. Next, enter the ID number (for individuals, families, sources or repositories) or name (places only) of the link entity. If you don't know the ID number or exact place name, click the Find... button to search for it.

Link to specific event
If you wish to link this media item to a specific event associated with the link entity, check the box marked "Link to specific event". That will cause an additional dropdown box to appear, from which you will select the specific event. WARNING: Links to specific events created within TNG may be overwritten by subsequent imports.

Alternative Title/Description
You can also enter an "Alternate Title" and "Alternate Description" for each link. If you supply anything here, the alternate title/description will be used instead of the main title/description entered above when this media item is displayed in conjunction with a linked entity. If no alternate description or note is supplied, the main title and description will always be used.

Make Default
TCheck this box to use the thumbnail for this media item on the pedigree chart and at the top of other pages related to the individual or entity to which the item is being linked.

Add Another Link
To create another link for this media item, click the Add Another Link button. Another set of link fields should appear without the page reloading.

Image Map
To link different portions of your image to different pages, or to display short messages when the mouse pointer is over those portions, enter the needed image map code in this box. To construct your own image map, see the Image Map Construction section at the bottom of the page. Note: The media item must be a valid JPG, GIF or PNG image to use this feature.


Image Map Construction

For each region you want to link to an individual, first select the individual's tree, then select a shape (circle or rectangle) for the region (more complex shapes are possible, but you must supply the code for those). Next, follow the instructions for the selected shape to properly select your image coordinates. After the coordinates have been selected, a "Find..." box will be displayed. Enter all or part of the individual's name or ID to locate possible matches, then choose the correct individual from the candidates displayed. The box will close and the code for this region will be added to the Image Map box above. You may edit that code if necessary.

Repeat this process for any additional regions needed. All new code will be added to the end of that already in the Image Map box.


Delete Media

To delete one media item, click on the Delete icon next to that item on the Manage tab. To delete more than one item at a time, check the Select box next to each item to be deleted, then click the Delete Selected button at the bottom.


Convert

To convert media items from one media type or "collection" to another, check the Select box next to those items on the Manage tab, then scroll to the bottom and select a new collection from the dropdown box there next to the "Convert Selected to" button. Finally, click the "Convert Selected to" button.


Add to Album

To add media to an album, check the Select box next to the items to be added, then scroll to the bottom and select an album from the dropdown box there next to the "Add to Album" button. Finally, click the "Add to Album" button. Media can also be added to albums from Admin/Albums.


Sort Media

By default, media linked to an individual, family, source, repository or place are sorted by the order in which they were linked to that entity. To change that order, you must indicate a new order on the Sort tab.

Tree, ID:
First select the tree associated with the entity for which you would like to sort media. Next, enter the ID number (for individuals, families, sources or repositories) or name (places only) of the entity. If you don't know the ID number or exact place name, click the Find... button to search for it.

Link to specific event
If you wish to sort only the media items attached to a specific event associated with the link entity, check the box marked "Link to specific event". That will cause an additional dropdown box to appear, from which you will select the specific event.

Sort Media for [ID:Name]
To affect the order in which thumbnails are displayed for an individual, family, source, repository or place, enter a numeric value next to each thumbnail or click on the arrows to move the entries up or down dynamically. Lower numbers sort first, and you may use decimals to insert one media item between two others if convenient. For example, if you have 50 photos and want to move number 50 to the number 10 slot, you could change 50 to 9.5 and update the list. When the list redisplays, the media items will be renumbered in the new order. To use a particular item as the default for this individual, family or source (displayed on the pedigree chart and at the top of all pages related to this individual, or at the top of the family group sheet for families), click the button labeled "Make Default" in the row for that photo. Note: the item must be an image and must have a thumbnail for this.


Thumbnails

Generate Thumbnails
When you click on the "Generate" button under this option, TNG will automatically create thumbnails for all JPG, GIF or PNG images that do not already have an existing thumbnail. By default, the name of the new image will be the same as the larger image but with a prefix and/or suffix as defined by you in the General Settings. Check the box labeled "Regenerate existing thumbnails" to create thumbnails for all images, including those that already have them. NOTE: If you do not see the Generate Thumbnails section, your server does not support the GD image library.

Assign Default Photos
This option allows you to make the first photo for each individual, family and source be that entity's "default" photo (the one displayed on pedigree charts, family group sheets, and at the top of other pages assigned to that entity). The assignment can be made for all individuals, families, sources and repositories in a particular tree by selecting that tree from the dropdown box. Check the box labeled "Override existing defaults" to set defaults regardless of what has previously been set. Leaving this box unchecked allows previously set defaults to remain.