PHPackages                             stephenwf/omeka-s - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. stephenwf/omeka-s

ActiveProject

stephenwf/omeka-s
=================

The Omeka S collections management system. A local network of independently curated exhibits sharing a collaboratively built pool of items and their metadata.

v1.0.0-beta3(9y ago)07541GPL-3.0PHPPHP &gt;=5.6

Since Jun 30Pushed 8y ago1 watchersCompare

[ Source](https://github.com/stephenwf/omeka-s)[ Packagist](https://packagist.org/packages/stephenwf/omeka-s)[ RSS](/packages/stephenwf-omeka-s/feed)WikiDiscussions develop Synced today

READMEChangelogDependencies (64)Versions (19)Used By (1)

Omeka S
=======

[](#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.

Installation
------------

[](#installation)

### Requirements

[](#requirements)

- Linux
- Apache
- MySql 5.5.3+ and the MySQL driver for PDO
- PHP 5.6+ (the latest stable version preferred) and the PHP extensions for PDO

### Gotchas

[](#gotchas)

- The default library for generating thumbnails is ImageMagick, at least version 6.7.5. Older versions will not correctly produce thumbnails. See local.config.php options below.

### Installing from GitHub

[](#installing-from-github)

1. Clone this repository in your Apache web directory:
    - `$ git clone https://github.com/omeka/omeka-s.git`
2. Change into the Omeka S directory:
    - `$ cd omeka-s`
3. Perform first-time setup:
    - `$ npm install`
    - `$ npm install --global gulp-cli` (if you do not already have `gulp` installed)
    - `$ gulp init`
4. 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.
5. Make sure the `files/` directory is writable by Apache.
6. In your web browser, navigate to the omeka-s directory, where you can complete installation.

### Installing from released zip file

[](#installing-from-released-zip-file)

1. Download the latest release from the [release page](https://github.com/omeka/omeka-s/releases)
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
--------

[](#updating)

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

### Updating from GitHub

[](#updating-from-github)

1. `git pull` as usual. Before the official release, latest code will be on branch 'develop'.
2. From the Omeka S root directory, run `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

[](#updating-from-released-zip-file)

1. Download the latest release from the [release page](https://github.com/omeka/omeka-s/releases)
2. Make a copy of your `/config/local.config.php` file.
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.

local.config.php options
------------------------

[](#localconfigphp-options)

- `thumbnailer` Default is `Omeka\File\ImageMagickThumbnailer`. Also available are `Omeka\File\IMagickThumbnailer` and `Omeka\File\GdThumbnailer`
- `phpcli_path` Default is to attempt to detect correct path to PHP. Use this option to specify a path if needed in your server configuration. For example:

```
    'cli' => array(
        'phpcli_path' => '/usr/bin/php55',
    ),

```

Libraries
---------

[](#libraries)

Omeka uses the following libraries, among others:

- [Zend Framework 3](http://framework.zend.com/)
- [Doctrine 2](http://www.doctrine-project.org/)
- [EasyRdf](http://www.easyrdf.org/)
- [PHPUnit](https://phpunit.de/)
- [jQuery](http://jquery.com/)

Coding Standards
----------------

[](#coding-standards)

Omeka development adheres to the [Zend Framework 2 Coding Standards](https://zf2-docs.readthedocs.org/en/latest/ref/coding.standard.html)and uses the [git-flow](http://nvie.com/posts/a-successful-git-branching-model/) branching model.

###  Health Score

28

—

LowBetter than 54% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity13

Limited adoption so far

Community20

Small or concentrated contributor base

Maturity53

Maturing project, gaining track record

 Bus Factor2

2 contributors hold 50%+ of commits

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~71 days

Recently: every ~66 days

Total

10

Last Release

3321d ago

Major Versions

v0.8.0-alpha → v1.0.0-beta2016-11-01

PHP version history (3 changes)v0.2.0-alphaPHP &gt;=5.5

v0.3.0-alphaPHP &gt;=5.5.2

v0.8.0-alphaPHP &gt;=5.6

### Community

Maintainers

![](https://www.gravatar.com/avatar/c0e5a9b913301f2fb80dcb626b96d6e5b324522a8201e09f2761729bd1e8ce3b?d=identicon)[stephenwf](/maintainers/stephenwf)

![](https://www.gravatar.com/avatar/23beedbea02442905f1eb64995a01ffd6c265424b563fc2050c38b1acfafab32?d=identicon)[Digirati](/maintainers/Digirati)

---

Top Contributors

[![jimsafley](https://avatars.githubusercontent.com/u/141955?v=4)](https://github.com/jimsafley "jimsafley (2130 commits)")[![zerocrates](https://avatars.githubusercontent.com/u/298975?v=4)](https://github.com/zerocrates "zerocrates (953 commits)")[![kimisgold](https://avatars.githubusercontent.com/u/606764?v=4)](https://github.com/kimisgold "kimisgold (578 commits)")[![patrickmj](https://avatars.githubusercontent.com/u/153262?v=4)](https://github.com/patrickmj "patrickmj (436 commits)")[![kalbers](https://avatars.githubusercontent.com/u/371262?v=4)](https://github.com/kalbers "kalbers (149 commits)")[![elrossco22](https://avatars.githubusercontent.com/u/16711585?v=4)](https://github.com/elrossco22 "elrossco22 (35 commits)")[![Daniel-KM](https://avatars.githubusercontent.com/u/2138485?v=4)](https://github.com/Daniel-KM "Daniel-KM (24 commits)")[![stephenwf](https://avatars.githubusercontent.com/u/8266711?v=4)](https://github.com/stephenwf "stephenwf (15 commits)")[![jajm](https://avatars.githubusercontent.com/u/306836?v=4)](https://github.com/jajm "jajm (5 commits)")[![sharonmleon](https://avatars.githubusercontent.com/u/741480?v=4)](https://github.com/sharonmleon "sharonmleon (4 commits)")[![euanfergusson](https://avatars.githubusercontent.com/u/4094396?v=4)](https://github.com/euanfergusson "euanfergusson (3 commits)")[![stl74](https://avatars.githubusercontent.com/u/17853285?v=4)](https://github.com/stl74 "stl74 (1 commits)")

###  Code Quality

TestsPHPUnit

Code StylePHP CS Fixer

### Embed Badge

![Health badge](/badges/stephenwf-omeka-s/health.svg)

```
[![Health](https://phpackages.com/badges/stephenwf-omeka-s/health.svg)](https://phpackages.com/packages/stephenwf-omeka-s)
```

###  Alternatives

[zf-commons/zfc-user

A generic user registration and authentication module for ZF2. Supports Zend\\Db and Doctrine2.

4851.1M70](/packages/zf-commons-zfc-user)[socalnick/scn-social-auth

Uses the HybridAuth PHP library to Enable authentication via Google, Facebook, Twitter, Yahoo!, etc for the ZfcUser ZF2 module.

21974.2k3](/packages/socalnick-scn-social-auth)[stroker/form

ZF2 module for extending forms with live clientside validation

4157.1k](/packages/stroker-form)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
