Plugins/MyOmeka

About MyOmeka

The MyOmeka plugin allows users of an Omeka site to create their own accounts and save items in the archive by tagging and creating personal annotations. Those annotations can then easily be shared with others by creating "posters," which are simple, one-page exhibits incorporating those items and annotations into a single page.

The plugin is currently being used on several popular CHNM sites, including the Bracero History Archive, and Making the History of 1989.

Configuring Plugin

During the installation process (Installing_a_Plugin), you'll have the option of customizing the plugin's URL slug, title, disclaimer, and specify whether or not you're using the TermsOfService plugin in conjunction with MyOmeka.

  • Relative Page Path From Project Root: This is the URL that the plugin creates. By default, the plugin creates URLs like mywebsite.com/myomeka/, however you can customize it by editing this field.
  • MyOmeka Title: The section's title can be customized for particular uses of the plugin, such as My Collection, My Archive, My Stuff, et al.
  • MyOmeka Disclaimer: The disclaimer text appears below every public poster created by MyOmeka users.
  • Require Terms of Service And Privacy Policy: By checking this box, you'll be required to have activated the Terms of Service plugin. These plugins will require users to check that they've read the TOS and privacy policy before registering for your site.

Editing Theme for Public Access

Once My Omeka is configured, you will want to make My Omeka available to your users. To do so, you must edit the public theme.

  • On the server, find the directory for the current design theme. Open the directory and then the common folder. Inside open the header.php file (/yourtheme/common/header.php).
  • Insert the following snippet of code in header.php file just above the search div.
    <?php echo my_omeka_user_status(); ?>

    Your can place the snippet of code anywhere in your theme file, depending on what modifications you've already made. After adding the code, your theme may look like this:

    <?php echo my_omeka_user_status(); ?>
    <div id="search-wrap">
        <h2>Search</h2>
        <?php echo simple_search(); ?>
        <?php echo link_to_advanced_search(); ?>
    </div>
  • Once saved and uploaded back to the server, users of your website will now have a link to create accounts and save their own items to My Omeka.
  • In addition to adding a link to MyOmeka on the site that indicates whether or not a user is logged in, you may wish to customize the CSS of your theme to style the look of the plugin. This varies from theme-to-theme.
  • You will also want to confirm that the following snippet of code is present on the items/show page so that users can add notes and tags as they browse the archive. This line should appear at the end of the page somewhere above <?php foot(); ?>
    <?php echo plugin_append_to_items_show(); ?>

Accessing MyOmeka Content

  • Users click on the Login |Register link in the header.
  • Once logged in, users access their saved items and notes by clicking on their name, that appears on each page in the site's header.

MyOmeka with other Plugins

Keep in mind that if you are activating other plugins that append the items/show page for displaying content those elements may crowd the page's public display.