an open platform to explore digitised art collections from public galleries and museums
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.github
app
bootstrap
config
database
public
resources
storage
tests
.env.example
.env.testing.example
.gitattributes Initial commit for Laravel5 version May 11, 2016
.gitignore
CHANGELOG.md
CODE_OF_CONDUCT.md
CONTRIBUTING.md
ES2_migration_steps.txt
LICENSE
README.html
README.md
artisan
composer.json
composer.lock
elasticsearch_settings.json
package.json
phpunit.xml Various upgrades for Laravel 5.2 Jun 1, 2016
server.php

README.md

Welcome

Web umenia is an open platform to explore digitized art collections from public galleries and museums.

Web umenia is developed by lab.SNG: the digital R&D lab of the Slovak National Gallery. We are working with public art organisations to make their art accessible and explorable online so curious people around the world can learn more about works of art and the context they've been created in.

Web umenia offers a user-friendly way to search and explore art from collections of multiple galleries and museums.

Digital reproductions of public domain artworks from several collections are available for download in high resolution for both personal and commercial use

Art organisation with digitized artworks organised in a Collection Management System can easily publish their art via CSV imports or OAI-PMH harvests. If you would like to know more about using Web umenia in your organisation, contact us via lab@sng.sk

Developers interested to build applications on top of Web umenia can use our API. See our wiki on GitHub for more info.

Contributing

We greatly encourage others to get involved! See our contributing guidelines for more info about different ways to contribute to Web umenia.

We are committed to providing a welcoming and inspiring community for all and expect others who participate in the project to honour our code of conduct.

Tech setup

Requirements

This software is built with the Laravel5 framework.

It requires

  • PHP 5.5.9+
  • MySQL
  • Elasticsearch

Local Installation

Here are the steps for installation on a local machine.

  1. Clone this repository.
    git@github.com:SlovakNationalGallery/web-umenia-2.git webumenia/
    cd webumenia/
    
  2. Setup database in your favourite database editor. set:
    • db name
    • username
    • password
  3. Configure access to your database in /app/config/database.php
  4. Set .env file. you can copy values from .env.example
  5. Run composer install to fulfil required libraries.
  6. Make sure elasticsearch is running. you can set the index name in app/config/app.php
  7. Run migrations to setup the database with php artisan migrate --seed
  8. Start your queue listener and setup the Laravel scheduler (optional)

Harvesting Data

You can now fill artworks by adding them manually or importing using the "spice harvester" (harvests using OAI-PMH protocol) using php artisan oai-pmh:harvest and choosing to harvest 1 [item] Europeana SNG. Or login to admin at http://yourlocalhost/admin using default credentials admin/admin and go to Spice Harvester -> 'Spustit'.

IIPImage

This application uses IIPImage server for zoomable (and downloadable) images.

IIPImage must be seen locally, what can be achieved using a ProxyForwarding.

To enable image server for default oai set (Europeana), put this lines of code into your virtualhost setup:

ProxyPass /fcgi-bin/iipsrv.fcgi http://imi.sng.cust.eea.sk/publicIS/fcgi-bin/iipsrv.fcgi

ProxyPassReverse /fcgi-bin/iipsrv.fcgi http://imi.sng.cust.eea.sk/publicIS/fcgi-bin/iipsrv.fcgi

Updating Elastic Search

  • necessary steps are specified in the file ES2_migration_steps.txt
  • command to generate ES2 compatible index: php artisan es:setup
  • command to reindex data to the index php artisan es:reindex

Maintainer

This project is maintained by lab.SNG. If you have any questions please don't hesitate to ask them by creating an issue or email us at lab@sng.sk.

License

Source code in this repository is licensed under the MIT license. Please see the License File for more information.