omeka/omeka-s omeka/omeka-s

  • Stars
    star
    382
  • Rank 111,911 (Top 3 %)
  • Language
    PHP
  • License
    GNU General Publi...
  • Created about 11 years ago
  • Updated 6 months ago
Twitter logo Share LinkedIn logo Share Facebook logo Share
omeka/omeka-s
github

omeka

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Omeka S is a web publication system for universities, galleries, libraries, archives, and museums. It consists of a local network of independently curated exhibits sharing a collaboratively built pool of items, media, and their metadata.

Omeka S

Omeka S is a web publication system for universities, galleries, libraries, archives, and museums. It consists of a local network of independently curated exhibits sharing a collaboratively built pool of items, media, and their metadata.

See the user manual for more information.

Installation

Requirements

Generating thumbnails

  • The default library for generating thumbnails is ImageMagick, at least version 6.7.5. Older versions will not correctly produce thumbnails. For alternative thumbnail options, see the user manual.

Installing from GitHub

  1. Make sure Node.js and npm are installed
  2. Clone this repository in your Apache web directory:
    • $ git clone https://github.com/omeka/omeka-s.git
  3. Change into the Omeka S directory:
    • $ cd omeka-s
  4. Perform first-time setup:
    • $ npm install
    • $ npx gulp init
  5. Open config/database.ini and add your MySQL username, password, database name, and host name. The user and database must be created before this step.
  6. Make sure the files/ directory is writable by Apache.
  7. In your web browser, navigate to the omeka-s directory, where you can complete installation.

Installing from released zip file

  1. Download the latest release from the release page (download the first asset listed)
  2. Open config/database.ini and add your MySQL username, password, database name, and host name. The user and database must be created before this step.
  3. Make sure the files/ directory is writable by Apache.
  4. In your web browser, navigate to the omeka-s directory, where you can complete installation.

You can find Omeka-specific code under application/.

Updating

Make a backup copy of your entire site and its database!

Updating from GitHub

  1. git pull as usual. Use the master branch for the latest releases.
  2. From the Omeka S root directory, run npx gulp deps to make sure dependencies are up to date.
  3. Compare changes in /config/local.config.php and /config/local.config.php.dist. Some default configurations might have changed, so you might need to reconcile changes to the distributed configuration with your local configuration (e.g., a path to PHP specific to your server, dev mode settings, etc.)
  4. In your web browser, go to your site and run any migrations that are needed.

Updating from released zip file

  1. Download the latest release from the release page
  2. Make a copy of your /config directory. You will need to restore your local.config.php and database.ini files from that copy.
  3. Make a copy of your /modules and /themes directories.
  4. Make a copy of your /files directory.
  5. Remove all Omeka S files, and replace them with the files from the updated zip file.
  6. Replace your original /config/local.config.php file, and the /modules, /themes, and /files directories that you copied.
  7. In your web browser, go to your site and run any migrations that are needed.

Creating a zipped release

Run npx gulp zip to create a zipped version of Omeka S and store it in /build. Use the --no-dev flag to omit Composer dev dependencies for a smaller package suitable for end-users. Official releases follow this same process from a new, clean checkout.

Libraries

Omeka uses the following libraries, among others:

Development Standards

Omeka development adheres to the Laminas Coding Style Guide and uses the git-flow branching model and the Semantic Versioning 2.0.0 version scheme.

See the developer documentation for more information.

Copyright

Omeka is Copyright © 2015-present Corporation for Digital Scholarship, Vienna, Virginia, USA http://digitalscholar.org

The Corporation for Digital Scholarship distributes the Omeka source code under the GNU General Public License, version 3 (GPLv3). The full text of this license is given in the license file.

The Omeka name is a registered trademark of the Corporation for Digital Scholarship.

Third-party copyright in this distribution is noted where applicable.

All rights not expressly granted are reserved.

More Repositories

1

Omeka

A flexible web publishing platform for the display of library, museum and scholarly collections, archives and exhibitions.
PHP
482
star
2

plugin-ExhibitBuilder

Allows users to develop online interpretive exhibits that combine items in the Omeka archive with narrative text. The plugin provides pre-built themes and layouts, and a WYSIWYG visual editor, to build complex pages.
PHP
23
star
3

omeka-s-enduser

Omeka S End User documentation. Scroll down for an index and more information
HTML
20
star
4

plugin-CsvImport

Allows users to import items from a simple CSV (comma separated values) file, and then map the CSV column data to multiple elements, files, and/or tags. Each row in the file represents metadata for a single item. This plugin is useful for exporting data from one database and importing that data into an Omeka site.
PHP
20
star
5

plugin-Scripto

Adds the ability to transcribe items using the Scripto library.
PHP
18
star
6

PythonOmekaApiToCsv

Python script for exporting metadata from Omeka to a CSV file via the Omeka API.
Python
17
star
7

omeka-s-developer

Documentation for Omeka S developers
16
star
8

plugin-Geolocation

Allows administrative users to save geolocation data for an individual item. The plugin generates a Google map containing items with geolocation data and a web page for displaying the map.
JavaScript
12
star
9

plugin-OaipmhHarvester

OAI-PMH harvester for Omeka
PHP
9
star
10

classic-enduser

End user documentation for Omeka Classic
HTML
8
star
11

plugin-Dropbox

Allows Omeka users to "batch upload" a large quantity of files at one time or to upload large files, by adding those files to a folder on the server hosting an Omeka site. Dropbox creates unique items in the archive for each file, or allows administrative users to associate dropbox files with an item through the add or edit items interface.
PHP
8
star
12

plugin-Contribution

Makes an Omeka site into one that accepts public contributions. The plugin provides a form to collect stories, images, or other files from the public and manages those contributions in your Omeka archive as items. This contribution is useful when creating digital memory banks
PHP
8
star
13

plugin-SimpleVocab

A simple way to create controlled vocabularies.
PHP
7
star
14

plugin-VraCore

Use the VRA Core metadata standard in Omeka
PHP
7
star
15

plugin-CollectionTree

Gives administrators the ability to create a hierarchical tree of their collections.
PHP
7
star
16

plugin-ItemRelations

Allows administrators to define relations between items.
PHP
7
star
17

plugin-SimplePages

Creates individual web pages for an Omeka site using a simple web form. It requires no programming knowledge, but allows users to add HTML markup, PHP code, or to embedding videos and other multimedia objects
PHP
7
star
18

plugin-ZoteroImport

Imports libraries and collections from Zotero user and group accounts.
PHP
6
star
19

Documentation

Documentation and tutorials for theme and plugin developers
Python
6
star
20

plugin-Reports

Generates report documents from Omeka items.
PHP
6
star
21

plugin-GuestUser

Adds a role allowing users with no access to the admin screen
PHP
6
star
22

theme-seasons

A colorful theme with a configuration option to switch style sheets for a particular season. For version 1.2 and above, Seasons offers the style sheets of earlier themes, Spring, Summer, Fall, Winter.
SCSS
6
star
23

plugin-DublinCoreExtended

Adds the full set of Dublin Core properties to the existing Dublin Core element set, including element refinements and supplemental elements. See: http://dublincore.org/documents/dcmi-terms
PHP
5
star
24

theme-foundation

An Omeka Classic theme based off ZURB Foundation
SCSS
5
star
25

plugin-DocsViewer

Embeds a Google document viewer into item show pages. PDF documents, PowerPoint presentations, TIFF files, and most Microsoft Word documents are supported.
PHP
5
star
26

theme-rhythm

An energetic two-column theme, with three different style sheet options. Works with Omeka versions 1.2 and above.
CSS
5
star
27

plugin-SimpleContactForm

Generates a short form that allows users to contact a designated individual and for the site to automatically respond to inquiries with an acknowledgment page and email.
PHP
5
star
28

plugin-OmekaApiImport

Use Omeka 2.1's API to do an Omeka site-to-site import
PHP
4
star
29

theme-emiglio

Named after our favorite robot, a simple, minimal theme with reds and blues
SCSS
3
star
30

plugin-Ngram

PHP
3
star
31

plugin-SearchByMetadata

Allows admins to configure metadata fields to link to a search for items with the same field value.
PHP
3
star
32

plugin-LcSuggest

Enable an autosuggest feature for Omeka elements using the Library of Congress Authorities and Vocabularies service: http://id.loc.gov
PHP
3
star
33

theme-minimalist

Clean lines, architectural.
CSS
3
star
34

plugin-CSSEditor

PHP
3
star
35

theme-berlin

Abstraction of the Making the History of 1989 theme.
CSS
3
star
36

plugin-Commenting

Threaded discussion of Omeka Items and other records
PHP
3
star
37

plugin-Coins

Adds COinS metadata to item pages, making them readable by the free bibliographic program, Zotero (http://zotero.org)
PHP
3
star
38

plugin-MultiCollections

Fakes the ability to put items in multiple collections
PHP
3
star
39

plugin-MediaRss

Adds a MediaRSS feed to Omeka page templates, making images available in a slideshow through the CoolIris Firefox extension.
PHP
2
star
40

theme-bigpicture

SCSS
2
star
41

plugin-PdfText

Extracts text from PDF files so they can be browsed and searched.
PHP
2
star
42

plugin-Posters

JavaScript
2
star
43

theme-dark

A theme in shades of gray and black.
PHP
2
star
44

plugin-Annotate

PHP
2
star
45

omeka-s-csv.py

Python
2
star
46

plugin-AjaxCreate

Omeka plugin to add a way to create new records via ajax
PHP
2
star
47

plugin-FileDownload

Provides a way to download files using their original file name.
PHP
2
star
48

plugin-PdfSearch

Extracts text from PDF files so they can be searched.
PHP
2
star
49

theme-santa-fe

Theme based on the Bracero History Archive
SCSS
2
star
50

plugin-Lcsh

Adds an autocomplete text box to the Dublin Core's Subject element, drawing from the Library of Congress Subject Headings.
PHP
2
star
51

plugin-ImageAnnotation

Allows site administrators and users to annotate images in an Omeka site, similar to the process available in Flickr.
PHP
2
star
52

plugin-ImageResize

Resizes image derivatives.
PHP
2
star
53

theme-thanksroy

A tribute to Roy Rosenzweig.
CSS
2
star
54

plugin-ExhibitImageAnnotation

JavaScript
2
star
55

plugin-Blocks

Adds blocks of content to a sidebar
PHP
2
star
56

plugin-TextAnalysis

PHP
1
star
57

plugin-EmbedCodes

Allows Omeka content to be embedded in other sites via an iframe
PHP
1
star
58

plugin-GoogleTranslate

Enables the Google Translate service on the Omeka admin and public site.
PHP
1
star
59

plugin-NetExport

Export functionality for omeka.net
PHP
1
star
60

plugin-TermsOfService

Allows administrators to specify their website terms of service and privacy policy.
PHP
1
star
61

plugin-MyOmeka

PHP
1
star
62

plugin-RecordRelations

PHP
1
star
63

plugin-Export

PHP
1
star
64

plugin-Groups

Adds zotero-style groups to Omeka
PHP
1
star
65

plugin-UserProfiles

PHP
1
star
66

theme-centerrow

SCSS
1
star
67

sept11

A command-line utility used to import September 11 Digital Archive collections into Omeka
PHP
1
star
68

TrainingMaterials

A set of example lessons and materials for conducting Omeka training sessions
PHP
1
star
69

plugin-SiteNotes

Provides an open form in the administrative dashboard to save notes or instructions about the site that is only accessible to those adding content to the Omeka site.
PHP
1
star
70

plugin-MallExtensions

PHP
1
star
71

plugin-ItemOrder

Gives administrators the ability to custom order items in collections.
PHP
1
star
72

theme-thedaily

SCSS
1
star
73

plugin-Installations

Used in Omeka Commons only
PHP
1
star
74

plugin-RedactElements

PHP
1
star
75

theme-fromscratch

PHP
1
star
76

plugin-ShortcodeCarousel

Add a shortcode to create a carousel of items
PHP
1
star
77

plugin-MuslimJourneysAdmin

Just some tools for building the Muslim Journeys site. Not for release as a general Omeka plugin
PHP
1
star
78

everywhere-enduser

End user documentation for Omeka Everywhere
1
star
79

plugin-DerivativeImages

PHP
1
star
80

plugin-UserTags

Allows tags to be associated with users, with some roles' tags being private.
PHP
1
star
81

plugin-Zoomit

Embeds a Zoom.it image viewer into item show pages
PHP
1
star
82

theme-griddy

PHP
1
star
83

plugin-SocialBookmarking

Inserts a list of social bookmarking sites to the bottom of each item in an Omeka archive, so that public users can easily share items they like with their social networks.
PHP
1
star
84

plugin-Editorial

Adds an Editorial block to Omeka Exhibits for private commentary and discussion of Exhibits in progress.
PHP
1
star
85

plugin-Locale

Configure language to use for an omeka.net site. Standalone Omeka users should use the config.ini setting if they have access.
PHP
1
star