Getting Started Omeka Classic plugin

Installation

Requirements

  • Omeka Classic 3.1 or later. Blog is built and tested on 3.2.2.
  • PHP 8.1 or later.
  • For the emails to moderators: Omeka's mail settings (mail.transport in application/config/config.ini) and Omeka's background jobs, which need the path to PHP's command-line program (background.php.path), as most hosts set.
  • Optional: Simple Pages, for the [blog_posts] shortcode; Exhibit Builder, for the Blog Posts block; MCP Server, for the blog's tools for AI assistants; API Browser, which documents the blog's API resources.

Installing

  1. Unzip Blog-1.0.0.zip and copy the Blog 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 Blog.

Installing creates six tables (blog_posts, blog_categories, blog_tags, blog_post_tags, blog_comments and blog_authors, with your Omeka table prefix) and one category, News, since every post needs a category. It makes no sample posts: on a live site they would go straight into the feeds, the sitemap and search engines.

After installing:

  • Blog appears in the admin menu, with the tabs Posts, Comments, Categories, Tags and Settings. Contributors see Posts only.
  • The public blog is at /blog, and a Blog link is added to the site's main navigation. Hide it, rename it or move it under Appearance > Navigation.
  • The Dashboard gets a Blog panel and a figure for published posts.

First steps

  1. Under Blog > Categories, rename News or add the categories you need.
  2. Under Blog > Settings, set the blog's title and description, and choose who gets the moderation emails.
  3. Click Add a Post under Blog > Posts, write, choose Published and save.

See Configuration for every setting and Managing Posts for the post form.

Upgrading

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

Uninstalling

Uninstalling drops the six tables, removes the blog's settings and takes its posts out of Omeka's search index. Every post, category, tag, comment and author bio is deleted. Back up first (for example with the Backup plugin, or through the REST API) if you may want them again.

The Blog link leaves the site's navigation by itself. Blog Posts blocks in exhibits then show only their text, and [blog_posts] shortcodes appear as typed: remove them first. Images in your collection used as featured images are not touched.

Log in for Support