Media

From TNG_Wiki
Jump to: navigation, search
Photos icon.gif
Media

See Media category under Categories or in Sub Category section of the Administrator Guide for other media related articles

Search

Locate existing media by searching for all or part of the Media ID, Title, Description, Path, Owner or Body Text (Histories only). Use the other available options to further narrow your search. Searching with no options selected and no value in the search box will find all media in your database. Search options include:

Tree

Restrict the results to media assigned to the selected tree.

Collection

Restrict the results to media of the selected Collection type. To add a new Collection, click on the "Add Collection" button, then fill out the form in the popup. You must create a folder for your new Collection, and you must create your own icon (or designate an existing one). The "Same setup as" field allows you to indicate which one of the basic Collection types your new Collection should emulate.

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

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

Cemetery

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

Your search criteria for this page will be remembered until you click the Reset button, which restores all default values and searches again.

Actions

http://tng.lythgoes.net/wiki/images/1/15/20080719010650.jpg

The Action buttons next to each search result allow you to edit, delete or preview that result. To delete more than one record at a time, click the box in the Select column for each record to be deleted, then click the "Delete Selected" button at the top of the list. Use the Select All or Clear All buttons to toggle all select boxes at once. You can also convert multiple items from one Collection to another, or add multiple items to an Album in the same manner (see below for more information).

Adding New Media

To add new media, click on the Add New tab, then fill out the form. Some information, including the image map, location information, and links to people, families and other entities, can be added after saving or locking the record. Take note of the following:


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.

This media...

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 web address (for example, http://www.thatsite.com/image.jpg) in the field labeled "Media URL", and you must provide your own thumbnail if you wish to have one (TNG will not create one).

Note that you can also supply a relative URL that points to a different location on your server, such as Media URL

../daigle/photos/100-0045_IMG.JPG

which points to the photos folder used for my Holy Family Cemetery in Daigle, Maine database which is separate from the TNG genealogy database

https://www.royandboucher.com/daigle/photos/100-0045_IMG.JPG

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 the "Browse" button and locate it on your hard drive. If the item is already on your site, leave this field blank.

File name on site / Media URL

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, or click on the "Select" button to locate the file within the proper Collection folder. 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. If you indicated this media comes from an external source, this field label will change to "Media URL", in which case you would enter the absolute URL .

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).

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.

NOTE: If you are using HTML, do not include the HTML or BODY tags.

Convert line...

Convert line breaks to HTML on display

(Histories only) 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 the "Browse" button 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 or online file manager to create the directory and give it proper rights (775 should work, but 777 is required on some sites).

Store files...

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

These are optional. If you know this information, enter it in the appropriate areas.

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.

Cemetery

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

Plot

(Headstones only) The plot where the headstone is located (optional).

Status

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

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.

Link this media...

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...

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.

Editing Existing Media

To make changes to existing media, use the Search tab to locate the item, then click on the Edit icon next to that item. Take note of the following items that are not on the "Add New Media" page:

Media Links

You can link this media item to individuals, families, sources, repositories or places. For each link, first select the tree associated with the link entity. Next, select the Link Type (Person, Family, Source, Repository or Place), and finally, enter the ID number or name (Places only) of the link entity. After all the information has been entered, click on the "Add" button.

If you don't know the ID number or exact Place Name, click the magnifying glass icon to search for it. A popup window will appear to let you do the searching. When you find the desired entity description, click the "Add" link at the left. You may click "Add" for multiple entities. When you are finished creating links, click on the "Close Window" link.

Existing Links: You may edit or delete an existing link by clicking on the Edit or Delete icon next to that link. Editing a link allows you to associate the link with a specific event and give it an Alternate Title and Alternate Description.

WARNING: Links to specific events created within TNG may be overwritten by subsequent GEDCOM imports.

Make Default

While editing a Media Link, you can also elect 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.

Place Taken/Created

This section will start out collapsed. To expand, click on the "Place Taken/Created" header, or the arrow next to it. If you know the name of the place where the photo was taken, enter it in the field labeled "Place Taken/Created".

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. Alternatively, you can use the Google Map geocode function above to set the latitude and longitude for the media location. Click on the "Show/hide clickable map" button to reveal the Google Map.

Zoom

Enter the zoom level or adjust the zoom controls on the Google Map above to set the zoom level. This option is only available if you have received a "key" from Google and entered it in your TNG Map Settings.

Note: The Latitude/Longitude/Zoom information for media items is for informational purposes only. The location is not pinpointed on any map in the public area.

Image Map

This section will start out collapsed. To expand, click on the "Image Map" header, or the arrow next to it. This section allows you to link different portions of the image to individuals in your database, or to display short messages when the mouse pointer is over those portions.

Note: The media item must be a valid JPG, GIF or PNG image to use this feature.

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 popup box will be displayed to allow you to find or enter the individual's ID. 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 below the image. You may edit that code if necessary, or you may enter the image map code directly if desired.

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.

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.

Deleting Media

To delete one media item, use the Search tab to locate the item, then click on the Delete icon next to that item. The row will change color and then vanish as the item is deleted. To delete multiple media at a time, check the box in the Select column next to each item to be deleted, then click the "Delete Selected" button at the top of the page.

Converting Media...

Converting Media From One Collection to Another

To convert media items from one media type or "Collection" to another, check the Select box next to those items on the Search tab, then select a new Collection from the dropdown box at the top of the page next to the "Convert Selected to" button. Finally, click the "Convert Selected to" button. The page will redisplay with a red status message at the top.

Adding Media to Albums

To add media to an Album, check the Select box next to the items to be added, then select an Album from the dropdown box at the top of the page next to the "Add to Album" button. Finally, click the "Add to Album" button. Media can also be added to Albums from Admin/Albums.

Sorting Media

By default, media linked to a Person, 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 Media/Sort tab.

Tree, Link Type, Collection:

Select the Tree associated with the entity for which you would like to sort media. Next, select a Link Type (Person, Family, Source, Repository or Place) and the Collection you would like to sort.

ID:

Enter the ID number or name (Places only) of the entity. If you don't know the ID number or exact place name, click the magnifying glass icon to search for it. When you find the desired entity, click on the "Select" link next to that entity. The popup will close and the selected ID will appear in the ID field.

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" AFTER all the other fields &emdash; including ID &emdash; are filled in. That will cause an additional dropdown box to appear, from which you will select the specific event (optional).

Sorting Procedure

After selecting or entering an ID, click on the "Continue" button to display all media for the selected entity and Collection in their current order. To reorder the items, click on the "Drag" area for any item and hold the mouse button down while moving the mouse pointer to the desired location within the list. When the item has reached the selected point, release the mouse button ("drag and drop"). Changes are automatically saved at that point.

Default Photos

While sorting, you may also select any of the displayed photos as the current entity's Default Photo. That means that the thumbnail for the selected image will appear on pedigree charts and in page titles with the current entity's name or title. To set or remove a Default Photo designation, hold your mouse pointer over any of the listed images, then click on either of the now visible options of "Make Default" or "Remove". The current Default Photo may also be removed by clicking on the "Remove Default" link at the top of the page.

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. Check "Regenerate thumbnail path names were file does not exist" if you think you have some thumbnail records that point to invalid files. That will cause TNG to reevaluate the thumbnail path names before regenerating the thumbnail. Without this feature, the same invalid thumbnail name would be regenerated over and over.

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.

Importing Photos

This feature creates a media record for each physical file in any of your TNG media folders, with the file name as the title. To perform the import, first select a Collection (or add a new collection first) and a Tree (if the incoming items should be associated with that tree), then click the "Import" button. If a record already exists for an item, no new record is created.


Related links

Media Overview
Setup - Media

Using Collections

Adding Media

Body Text

Thumbnails

Image Maps

Other Useful Articles

Some TNG Media Mods