tainacan/src
Eduardo Humberto abc704f92d Youtube Importer: fix errors and set importer visible 2019-04-24 19:27:42 -03:00
..
admin add version to css and js files to avoid cache 2019-04-16 17:56:03 -03:00
api Merge branch 'develop' into feature/facets_ES 2019-04-16 11:50:36 -03:00
assets/css Little css adjustment to Gutenberg blocks. 2019-04-16 15:53:33 -03:00
classes adding more options to display metadata html #227 2019-04-23 16:40:21 -03:00
dev-interface re-refactor metadata types name 2018-06-11 14:58:08 -03:00
exporter add verification for empty metadata values (#211) 2019-03-21 12:56:33 -03:00
exposers validate request and return 404 when exposer dsnt suppor mapper 2018-12-03 15:19:13 -02:00
gutenberg-blocks Important fix: fetches items according to elastic search return on items modal inside gutenberg. 2019-04-24 12:47:45 -03:00
importer Youtube Importer: fix errors and set importer visible 2019-04-24 19:27:42 -03:00
js Merge branch 'develop' into feature/facets_ES 2019-04-16 11:34:23 -03:00
languages Renaming it_IT translation files 2019-03-28 12:34:03 -03:00
mappers FIx creation of mapped collection 2019-02-05 17:05:45 -02:00
oaipmh-expose create verification in metadata object (ref. #181) 2019-02-11 19:53:56 -02:00
pdf-viewer Cleaning the house 2018-05-04 19:06:54 -03:00
scss Responsive Embeds 2018-05-23 15:24:17 -03:00
theme-helper adding more options to display metadata html #227 2019-04-23 16:40:21 -03:00
migrations.php Update database schema avoids error on installation 2019-04-08 18:28:35 -03:00
readme.txt changing release routine 2019-04-16 17:56:03 -03:00
tainacan.php add version to css and js files to avoid cache 2019-04-16 17:56:03 -03:00

readme.txt

=== Tainacan ===
Contributors: andrebenedito, daltonmartins, fabianobn, jacsonp, leogermani, weryques, wetah, eduardohumberto, ravipassos, jessicafpx, marinagiolo, omarceloavila
Tags: museums, libraries, archives, GLAM, collections, repository
Requires at least: 4.8
Tested up to: 5.1.1
Requires PHP: 5.6
Stable tag: 0.8.1
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-3.0.html

Tainacan is a powerful and flexible repository platform for WordPress. Manage and publish your digital collections just as easily as you post to your blog, having all the tools of a professional repository platform.

== Description ==

Tainacan is a powerful and flexible repository platform for WordPress. Manage and publish your digital collections just as easily as you post to your blog, having all the tools of a professional repository platform.

= Features =

* "Metadata and Filters": Use a metadata standard or choose whatever set of metadata you want to describe the items in your collections. Also, choose which metadata will be used as a filter when browsing collections.

* "Faceted Search". Browse your collection (and let the public browse it) using a faceted search interface with the filters you have chosen.

* "Manage Taxonomies": Manage vocabularies that can be used accross all your collections.

* "Themes": The Tainacan plugin has its own default theme, which helps you to showcase your collections in a beautiful and effective manner. But it can also work with any WordPress theme, so interface developers can easyly add Tainacan specific features to an existing theme.

* "API and Interoperability": Tainacan implements a RESTful API (read and write) to allow other applications to interact with your repository. That way, you can expose your collection in different formats, such as Json, JsonLD, OAI-PMH and others. If your collection has a specific set of metadata, you can map this metadata to match the patterns you want to use.

== Getting Started ==

After installation, you will see a new menu item in your admin panel called "Tainacan". Click on it to open the Tainacan admin interface.

To get an overview of the main concepts of Tainacan, please visit [this page](https://github.com/tainacan/tainacan/blob/develop/docs/key-concepts.md).

= Create a collection = 

Click "New Collection" to create a new collection, use a mapping standard or import using one of our importers.

= Configure your collection = 

Navigate the top menu to set your collection up. Create the metadata that items in this collection will have, and choose, from these metadata, which ones are going to be used as a filter.

= Add items = 

Back to the "Items" screen, click "Add new" to create a new item.

= Manage and browse your collection =

Through this admin interface you can manage your collection and browse its item using the faceted search interface or advanced search interface.

If you want to visit your collections in the public side of your site, using your current theme, visit http://your-site/tainacan-collection and you will get the list of your collections.

= Set up Taxonomies =

You can also have metada as taxonomies, which you can configure with a set of hierarchical terms of your own vocabulary.

= Add links to your menu =

Edit your menu and links directly to your collections. Click "Screen options" at the top of the Menu edition page and enable "Collections".

If you want to add a link to the list of collections, click "View all" tab on the Collections box on the left, and then add the first item named "Collections" to the menu.

= Faceted search in your theme =

We are still working in a way to enable faceted search in any theme. You can try it but it might not work very well depending on your theme.

In order to do this, use the shortcode "tainacan-search" in any page of your site (we recommend a full width template page), informing the ID of the collection you want to display.

Example: [tainacan-search collection-id=4]

== Installation ==

Upload the files to the plugins directory and activate it. You can also install and activate directly from the your admin panel.

If you have Imagick installed in your server, Tainacan will be able to automatically generate a thumbnail from your PDF files. This is desired but not required.

== Screenshots ==
 
1. Manage your repository
2. Set up your collection
3. Choose the metadata and filters for your collection
4. Add items described by your metadata
5. Set up your item as a file, link or text and attach many type of documents
6. Browse your collections with a faceted search interface
7. Navigate through rich filtering interface
8. Explore more with Advanced Search
9. Set up Taxonomies to be used across your repository
10. Bulk edit as many items as you need quickly
11. Expose your collection using Tainacan default theme