Generate: Dynamic Elements: Creative Commons Image

Overview

The Creative Commons Dynamic Element inserts a dynamic, random image from Creative Commons for each generated Page.

This image is stored in your Media Library.

Creative Commons imposes a rate limit of 5,000 requests per day and 60 requests per minute. This is specific to your web host’s IP address, so if you’re using this across multiple sites on the same shared host IP address, the limit applies to the sum of all requests from all sites.

Adding: Classic Editor / TinyMCE

To add a Creative Commons image within the Classic Editor:

Ensure that you’re using the Visual Editor by clicking the Visual tab:
Click the Creative Commons icon in the Visual Editor toolbar:

Adding: Classic Editor / TinyMCE: Text Editor

If you’re using the Text editor instead of the TinyMCE Visual Editor above:

Click the Creative Commons button in the toolbar:

Adding: Gutenberg

To add a Creative Commons image within Gutenberg:

Click the plus icon between two existing blocks, or towards the top left corner of the Gutenberg editor
Start typing Creative Commons into the Search for a block field, and click the Creative Commons option that appears within the Page Generator Pro section
Follow the Configuration section below for each of the fields displayed in the right hand sidebar’s block panel:

Adding: Page Builders

To add a Creative Commons image within any Page Builder that supports a Text Editor widget/module using the Classic Editor (sometimes known as TinyMCE), refer to the Classic Editor instructions above.

Refer to the Dynamic Elements Documentation for details specific to your Page Builder.

If your Page Builder does not provide a Text Editor widget/block that uses the Classic Editor, you can still use Dynamic Elements. However, you’ll need to manually build the shortcode, inserting it into your Page Builder’s content – for example:

[page-generator-pro-creative-commons parameter="value" ...]

Parameter	Accepted Value	Description
term	string or keyword	Fetch an image at random from Creative Commons matching the given Term.
orientation	0,tall,wide,square	The image orientation to search for on Creative Commons 0: Any orientation tall: Vertical / Portrait wide: Horizontal / Landscape square: Square
sources	comma separated list of values	Return images from the given source(s). If no value is specified, images from all sources will be included. 500px animaldiversity behance bio_diversity brooklynmuseum CAPL clevelandmuseum deviantart digitaltmuseum eol finnish_heritage_agency flickr floraon geographorguk iha mccordmuseum met museumsvictoria nasa national_museum_of_finland nypl phylopic rawpixel rijksmuseum sciencemuseum sketchfab smithsonian_african_american_history_museum smithsonian_african_art_museum smithsonian_air_and_space_museum smithsonian_american_art_museum smithsonian_american_history_museum smithsonian_american_indian_museum smithsonian_anacostia_museum smithsonian_cooper_hewitt_museum smithsonian_freer_gallery_of_art smithsonian_gardens smithsonian_hirshhorn_museum smithsonian_institution_archives smithsonian_libraries smithsonian_national_museum_of_natural_history smithsonian_portrait_gallery smithsonian_postal_museum smithsonian_zoo_and_conservation spacex statensmuseum stocksnap svgsilh thingiverse thorvaldsensmuseum waltersartmuseum wikimedia woc_tech wordpress WoRMS
licenses	comma separated list of values	Return images matching the given license(s). If no value is specified, images from all licenses will be included. BY-ND BY-NC PDM BY-NC-ND CC0 BY-SA BY BY-NC-SA BY-ND
copy	0,1	Whether to save the image to the Media Library.
size	thumbnail, medium, large	The image size to output. Other values may be available depending on the image sizes registered by your WordPress Theme and third party Plugins. Only works when copy = 1.
title	string or keyword	The title to assign to the image.
caption	string or keyword	The caption to assign to the image. Only works when copy = 1.
caption_display	integer (0,1)	If enabled, displays the caption below the image. Available in Page Generator Pro 4.5.2 and higher.
alt_tag	string or keyword	The alt tag to assign to the image.
description	string or keyword	The description to assign to the image. Only works when copy = 1.
filename	string or keyword	Define the filename to save the image as in the Media Library, excluding the extension. Only works when copy = 1.
attribution	0,1	If enabled, displays an image attribution below the image, linking to the author and license type the image is licensed under.
link_href	string or keyword	Define the link for the image. Leave blank for no link.
link_title	string or keyword	Define the link title for the image.
link_rel	string	Define the link rel attribute for the image.
link_target	string	Define the link target for the image. `_blank` New Window / Tab `_self` Same Window / Tab `_parent` Parent Frame `_top` Full Body of Window
exif_latitude	decimal or keyword	The image’s location’s latitude. Only works when copy = 1.
exif_longitude	decimal or keyword	The image’s location’s longitude. Only works when copy = 1.
exif_comments	string or keyword	Comments about the image. Only works when copy = 1.
exif_description	string or keyword	A description of the image. Only works when copy = 1.

Configuration: Search Parameters

The Sources option is available in Page Generator Pro 3.6.4, releasing Thursday April 28th 2022 23:59 UTC.

Term: Fetch an image at random from Creative Commons matching the given Term.
- Keywords can be used.
Image Orientation: The image orientation to search for
Sources: The images source(s) to search.
- If no value is specified, images from all sources will be included.
Licenses: The image licenses to include.
- If none are selected, all licenses are included.

Configuration: Output

The Display Caption option is available in Page Generator Pro 4.5.2, releasing Thursday 25th January 2024 23:59 UTC.

Page Generator Pro: Dynamic Elements: Creative Commons: Output

Save to Library: If enabled, stores the found image in the Media Library.
- Additional attributes, such as Caption, Filename and EXIF metadata can then be set.
- If disabled, the image will not be imported into the Media Library. This may result in faster generation times, and the image will be loaded direct from the third party image source.
Image Size: The image size to output.
- Other values may be available depending on the image sizes registered by your WordPress Theme and third party Plugins.
Title: The title to assign to the image.
- This can be a keyword.
Alt Tag: The alt tag to assign to the image.
- This can be a keyword.
Caption: The caption to assign to the image.
- This can be a keyword.
- If Save to Library isn’t enabled, this value is not set. This is because the value is stored in the WordPress Media Library, and therefore requires that the image be saved to the Media Library
Display Caption: If enabled, displays the caption below the image.
- If Save to Library isn’t enabled, this configuration option is not available. This is because the caption is only stored when saving the image to the WordPress Media Library.
Description: The description to assign to the image.
- This can be a keyword.
- If Save to Library isn’t enabled, this value is not set. This is because the value is stored in the WordPress Media Library, and therefore requires that the image be saved to the Media Library
Filename: Define the filename to save the image as in the Media Library, excluding the extension.
- This can be a keyword.
- It’s useful to use a keyword and/or other terms to ensure that the filename is SEO friendly and related to your content.
- If Save to Library isn’t enabled, this value is not set. This is because the value is stored in the WordPress Media Library, and therefore requires that the image be saved to the Media Library
Show Attribution: If enabled, displays an image attribution below the image, linking to the author and license type the image license.

As the image found on Creative Commons will be stored in your Media Library, the above attributes are stored against the image in the Media Library. It’s therefore recommended to complete at least the Alt Tag and Filename for SEO.

Configuration: Link

Page Generator Pro: Dynamic Elements: Creative Commons: Classic Editor: Link Settings

Link: Define the link for the image. Leave blank for no link.
- This can be a keyword.
Link Title: The title attribute for the link.
- This can be a keyword.
Link Rel: Define any rel attributes, such as nofollow.
Link Target: Whether clicking the link should open in the same window/tab, new window/tab etc.

Configuration: EXIF

Page Generator Pro: Dynamic Elements: Creative Commons: Classic Editor: EXIF Settings

The EXIF tab provides options to optionally write EXIF metadata to the image file. This can be useful for Image SEO.

Latitude: The image’s location’s latitude.
- If Save to Library isn’t enabled, this value is not set. This is because the image must be stored on the local web site for the EXIF metadata to be written
Longitude: The image’s locations’ longitude.
- If Save to Library isn’t enabled, this value is not set. This is because the image must be stored on the local web site for the EXIF metadata to be written
Comments: Comments about the image.
- If Save to Library isn’t enabled, this value is not set. This is because the image must be stored on the local web site for the EXIF metadata to be written
Description: A description of the image.
- If Save to Library isn’t enabled, this value is not set. This is because the image must be stored on the local web site for the EXIF metadata to be written

If any value is blank and the imported image contains an existing value in the EXIF metadata, the existing value will be retained.

Any other EXIF metadata is retained.