Cataloguing and data/media management application
Clone or download
collectiveaccess Merge pull request #340 from gaiasteph/useDefaultLocaleForServicesWhe…
…nNotProvided

Use default locale for services when not provided
Latest commit f24f6eb Sep 20, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
app Use default locale for services when not provided Sep 20, 2018
assets PROV-2427 Make change stick Apr 18, 2018
import Media importer staging directory now defaults to new "import" directo… May 27, 2012
install NOIJIRA remove profiles for release Apr 19, 2018
media NOJIRA add media directory with .htaccess Mar 3, 2014
support Merge branch 'develop' Apr 19, 2018
tests Merge branch 'develop' Apr 19, 2018
themes/default Merge branch 'develop' Apr 19, 2018
vendor NOJIRA write composer.lock Apr 19, 2018
viewers/apps Kill old Flash-based viewers Aug 1, 2015
.editorconfig NOJIRA add editorconfig Oct 30, 2017
.gitignore PROV-1293 Fix errors in Attribute and AttributeValue sync and start t… Mar 22, 2016
.htaccess NOJIRA add PDF extension to white list Apr 27, 2017
.travis.setup.php NOJIRA fix tests? Apr 12, 2018
.travis.yml NOJIRA Start testing with PHP 7.1; stop testing with PHP 5.5 Dec 22, 2017
License.txt Initial commit May 15, 2012
README.md NOJIRA fix minor typo Apr 19, 2018
THANKS.txt PROV-1776 Add StoryMap plugin Jul 13, 2016
Vagrantfile NOJIRA Vagrant config: Allow installer overwrite by default and overr… Jun 26, 2015
Warranty.txt Initial commit May 15, 2012
composer.json NOJIRA Pin phpunit at 5.7 Apr 17, 2018
composer.lock NOJIRA write composer.lock Apr 19, 2018
index.php PROV-2176 Remove reference Jul 24, 2017
service.php services Oct 7, 2015
setup.php-dist Fix documentation of constant. Sep 13, 2017

README.md

README: Providence version 1.7.6

Build Status

About CollectiveAccess

CollectiveAccess is a web-based suite of applications providing a framework for management, description, and discovery of complex digital and physical collections in museum, archival, and research contexts. It is comprised of two applications. Providence is the “back-end” cataloging component of CollectiveAccess. It is highly configurable and supports a variety of metadata standards, data types, and media formats. Pawtucket2 is CollectiveAccess' general purpose public-access publishing tool. It provides an easy way to create web sites around data managed with Providence. (You can learn more about Pawtucket2 at https://github.com/collectiveaccess/pawtucket2)

CollectiveAccess is freely available under the open source GNU Public License version 3.

Installation

First make sure your server meets all of the requirements. Then follow the installation instructions.

Updating from Providence version 1.7 or later

NOTE: The update process is relatively safe and rarely, if ever, causes data loss. That said BACKUP YOUR EXISTING DATABASE AND CONFIGURATION prior to updating. You almost certainly will not need it, but if you do you'll be glad it's there.

To update from a version 1.7.x installation decompress the CollectiveAccess Providence 1.7.6 tar.gz or zip file, and replace the files in your existing installation with those in the update. Take care to preserve your media directory, local configuration directory (app/conf/local), any local print templates (app/printTemplates) and your setup.php file.

Once the updated files are in place navigate in your web browser to the login screen. You will see this message:

Your database is out-of-date. Please install all schema migrations starting with migration #xxx. Click here to automatically apply the required updates, or see the update HOW-TO for instructions on applying database updates manually.

The migration number may vary depending upon the version you're upgrading from. Click on the here link to begin the database update process. Note that 1.7.6 introduces changes to the search index that necessitate modifying the structure of the index tables. On systems with a large search index these changes may take 30 minutes or more to complete.

Updating from Providence version 1.6 or earlier

NOTE: The update process is relatively safe and rarely, if ever, causes data loss. That said BACKUP YOUR EXISTING DATABASE AND CONFIGURATION prior to updating. You almost certainly will not need it, but if you do you'll be glad it's there.

To update from a version 1.6.x or older installation decompress the CollectiveAccess Providence 1.7.6 tar.gz or zip file, and replace the files in your existing installation with those in the update. Take care to preserve your media directory, local configuration directory (app/conf/local), and any local print templates (app/printTemplates).

Next rename your existing setup.php to something else (Eg. setup.php-old). Then copy the version 1.7.6 setup.php template in setup.php-dist to setup.php. Edit this file with your database login information, system name and other basic settings. You can reuse the settings in your old setup.php file as-is. Only the format of the setup.php file has changed.

Once the updated files are in place navigate in your web browser to the login screen. You will see this message:

Your database is out-of-date. Please install all schema migrations starting with migration #xxx. Click here to automatically apply the required updates, or see the update HOW-TO for instructions on applying database updates manually.

The migration number will vary depending upon the precise version you have installed, but in all cases will be less than 127.

Click on the here link to begin the database update process. The process may take several minutes with older installations requiring additional time. Note that 1.7.6 introduces changes to the search index that necessitate modifying the structure of the index tables. On systems with a large search index these changes may take 30 minutes or more to complete.

Version 1.7 introduced zoomable page media for multipage documents such as PDFs, Microsoft Word or Powerpoint. Systems migrated from pre-1.7 versions of CollectiveAccess will not have these zoomable media versions available causing the built-in document viewer to fail. If your system includes multipage documents you should regenerate the media using the command-line caUtils utility in support/bin. The command to run (assuming your current working directory is support/) is:

bin/caUtils reprocess-media 

Be sure to run it as a user that has write permissions on all media.

Useful Links

Other modules

Pawtucket2: https://github.com/collectiveaccess/pawtucket2 (The public access front-end application for Providence)