Installation

Requirements#

• Omeka Classic 3.1 or later. OG Images is built and tested on 3.2.2.
• PHP 8.1 or later with the GD extension, built with FreeType for text (most are). Images drawn from addresses outside the site need allow_url_fopen.
• A files folder the web server can write to: images are cached in files/og-images.
• Optional: Exhibit Builder, Simple Pages and Blog, for exhibit, page and blog post images.

Installing#

1. Unzip OgImages-1.0.0.zip and copy the OgImages folder into your Omeka Classic plugins/ folder.
2. Log in to the admin as a Super User and go to Settings > Plugins.
3. Click Install next to OG Images.

Installing creates a default template for each kind of page, and every public page gets its sharing image at once. OG Images appears in the admin menu for Super Users and Admins.

To check, open a public item page, view its source and look for og:image, or paste its address into a link preview tool such as the one in LinkedIn's Post Inspector or opengraph.xyz.

Upgrading#

Deactivate the plugin, replace the plugins/OgImages folder with the new version, then click Upgrade (or Activate) on the Plugins page.

Uninstalling#

Click Uninstall on the Plugins page, then delete the folder. The templates, settings and cached images are deleted.