Overview
The Image User Item adds an image to a page.
An Image User Item is a Content Item and does not create a page of its own. You must add it to a Page User Item or you will not see its content.
The Image User Item is for images that are not image exhibits. Image exhibits are images that are attached to records in your genealogy program. You manage image exhibits via properties in the Data > Exhibits section.
Image Section Properties
Title
The Title property identifies the User Item in the User Items list. The Title has no other purpose for Image User Items.
Enabled
See Enabled in the Common Properties section of the User Items help page.
Image
Click the Image button to select the image file you want to add to the page. GedSite will open a standard Windows "open file" dialog window. Use the navigation controls in that dialog window to move to the folder that contains the image you want to use. Select the image file, then click the [Open] button. GedSite will display the image.
Image File Handling
Immediately after you select the image file, GedSite will respond as follows:
- If the image file is located outside the Input (-i) folder, GedSite copies the image file to the
ui(user images) subfolder of the Input (-i) folder. - If the image file is located in a subfolder of the Input (-i) folder, including the
ui(user images) subfolder or any other subfolder, GedSite uses that image file and does not copy it. - If the image file is located in the Input (-i) folder, and not in a subfolder, GedSite copies the image file to the
ui(user images) subfolder of the Input (-i) folder.
The processing described above allows you to define subfolders under the Input (-i) folder to organize or categorize images. However, you must create the subfolders manually and copy the image files into the Input (-i) folder subfolders manually before you click the [Image...] button to choose the image.
If GedSite makes a copy of the image file, the original date is retained.
In any instance where GedSite makes a copy of the image file, if you subsequently change the original image file, the change will not be reflected in the site contents. You must edit the Image User Item and re-select the original file to update the copy used by the site. Optionally, you may manually update the copy of the file that is stored in a subfolder of the Input (-i) folder.
Use Embedded Caption
When the Use Embedded Caption property is checked, GedSite will attempt to read a caption from the metadata stored with the image in the image file.
When the Use Embedded Caption property is unchecked, GedSite will ignore the caption (if any) stored in the image file and use the Caption property text instead.
Caption
The Caption property is enabled when Use Embedded Caption is unchecked. When the Caption property is enabled, GedSite will use the contents of the Caption textbox as the caption for the image.
Clear
See Clear in the Common Properties section of the User Items help page.
Class
The Class textbox allows you to specify the name of a CSS class that will be added to the image's container. You may use the class in the selector of a User Style to customize the appearance of any Image User Items with the specified class name.
Page Section
See Page Section in the Common Properties section of the User Items help page.
Alignment
The Alignment pull-down menu controls whether the image appears inline, floats left, is centered, or floats right. When floated left or right, any subsequent content will flow around the picture on the opposite side.
Show Lightbox
When Show Lightbox is checked, which is the default, the image will include the Lightbox buttons.
Thumbnail Section Properties
Option
If the Option property is set to "Thumbnail", GedSite will make a reduced-size version of the image and insert the reduced size image on the page. The Width and Height properties determine the maximum dimensions of the reduced-size image. If the Width and Height properties are larger than the Width and Height of the image, the image will not be enlarged.
When GedSite creates a thumbnail image, the thumbnail will have the same aspect ratio as the original image.
Width
The Width property determines the maximum width of the reduced-size version of the image.
Height
The Height property determines the maximum height of the reduced-size version of the image.
Link Section Properties
Type
The Type property may be set to "No Link", "Link to person", or "Link to URL". When Type is set to "No Link", the image is not a link. This is the default.
URL
When Type is set to "Link to URL", the URL textbox is enabled. Enter the URL of a page. The image will become a link to the designated URL.
ID
When Type is set to "Link to person", the ID textbox is enabled and you may set it by keying the ID number of a person or choosing a person via the Picklist... button. The image will become a link to the designated person.
Add Reference
When Type is set to "Link to person", the Add Reference checkbox is enabled. If Add Reference is checked, GedSite will add a link-type reference to the linked person. The reference will will create a link to the page where this image appears.