Generate: Dynamic Elements: Creative Commons Image

The Creative Commons Dynamic Element is available in Page Generator Pro 2.6.9, releasing Thursday 11th June 2020 23:59 GMT.

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:

  • Click the Creative Commons icon in the Visual Editor toolbar:
    Page Generator Pro: Dynamic Elements: Icons: Classic Editor

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
    Page Generator Pro: Generate: Dynamic Elements: Gutenberg: Add Block
  • 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
    Page Generator Pro: Dynamic Elements: Creative Commons: Gutenberg: Search
  • Follow the Configuration section below for each of the fields displayed in the right hand sidebar’s block panel:
    Page Generator Pro: Dynamic Elements: Creative Commons: Gutenberg: Block

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.
size TODO The image size to search for on Creative Commons.
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
title string or keyword The title to assign to the image.
caption string or keyword The caption to assign to the image.
alt_tag string or keyword The alt tag to assign to the image.
description string or keyword The description to assign to the image.
filename string or keyword Define the filename to save the image as in the Media Library, excluding the extension.
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.
exif_longitude decimal or keyword The image’s location’s longitude.
exif_comments string or keyword Comments about the image.
exif_description string or keyword A description of the image.

Configuration: Search Parameters

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

  • Term: Fetch an image at random from Creative Commons matching the given Term.
    • Keywords can be used.
  • Image Size: The image size to search for
  • Image Orientation: The image orientation to search for

Configuration: Output

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

  • 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.
  • Description: The description to assign to the image.
    • This can be a keyword.
  • 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.
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.

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.
  • Longitude: The image’s locations’ longitude.
  • Comments: Comments about the image.
  • Description: A description of the image.

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.