Plugins/ExhibitBuilder

Description

The Exhibit Builder plugin allows you to develop online exhibits, or special web pages, that showcase a combination of digital objects in your Omeka archive with narrative text. Using pre-built themes and layouts, as well as our WYSIWYG visual editor, users can build complex pages without any programming knowledge.

Exhibits all follow the same structure, of sections and pages within sections. You may create as many sections and pages per exhibit as you like.


Getting Started

1. Click on the Exhibits tab in the top nav bar of the Admin interface, and click the "Add Exhibits" button on the right side. You will arrive at an Exhibit Metadata page. Fill in the empty fields.

  • Exhibit Slug (no spaces or special characters): This is the exhibit name as it appears in the website URL, for example, http://example.com/exhibits/show/myexhibitname
  • Exhibit Credits: These will appear with description on the public site.
  • Exhibit Description: An introduction to the entire exhibit that appears on the public site.
  • Exhibit Tags: Tags help associate exhibits with other items in your archive.
  • Exhibit is featured: Will this exhibit be featured on the browse exhibit page?
  • Exhibit is public/not public: If you are designing the exhibit in stages, you probably do not want to make your exhibit public. NB: Remember, if your exhibit is not public and you are logged in as a super or admin user, you will see the exhibit appear on your site as if it is public. Log out, and then look at your site.
  • Exhibit Theme: Choose an overall look for the exhibit. You may edit the theme's CSS to change exhibit design elements. See also, Creating an Exhibit Theme and Creating an Exhibit Layout

NB: If you want the exhibit to retain the same design theme as the rest of your site, do not choose a new theme.

Sections

2. To proceed with your exhibit, you must create sections so click "Add a Section."

3. A field for a title will appear. After you title the new section, click "Add a Section" again and it should appear under the Exhibit Section heading on that page.

4. To add text and items to an exhibit section, click the "edit" button to the right of the section title. From there, add a description/introduction/summary and create an optional URL slug for this section. The next step is to add pages to your section.

Pages

5. Click "Add a page" and enter page metadata including a page title, slug, and a layout for presenting different combinations of interpretative text and items from the archive. By saving the page metadata, a blank page has been created and you are redirected to the page content form.

6. At the top of the page content form, you'll see items from your archive listed. You may browse or search for specific items you want for the exhibit page. Once you find an item, drag it onto the page layout box. Smaller square boxes are for items. To change items, drag another item over the existing one. To remove an item, click the minus sign.

The text boxes which are in most layouts feature the TinyMCE WYSIWYG visual editor. You can resize and format text that'll be printed on the final layout. Note that CSS formatting in specific exhibit theme may control the appearance of this text, so the WYSIWYG editor may not always reflect how the final page looks.

NB: Thumbnail previews are created only for image files in exhibit pages. If you want to include an item that is a PDF, you also want to upload a small image file first that can act as an illustration of that PDF to appear in the items/show and exhibit page.

7. Before navigating away from this screen, be sure to save your work by clicking one of the two save options at the bottom of the screen. You do not need to complete the page, but please remember to save.

8. "Save and Add another Page" returns you to page layouts and allows you to choose one for the next exhibit page. "Save and Return to Section" takes you back to the exhibit section where you will find the pages you added.

9. Once you are finished adding pages to a section, be sure to hit "Save and Return to Exhibit." From here you may create new sections or "Save and Finish."

Editing Exhibits

10. Once an exhibit, section, or page is created, it may be edited at any time. To edit pages, first click edit next to the appropriate exhibit, then edit the proper section to get to the pages from that section.

When the exhibit is ready for your online visitors, don't forget to make it public.