Visual item ID selector / translatable relation texts + German translation

README.md

@@ -0,0 +1,90 @@
+Item Relations (plugin for Omeka)
+=================================
+
+[Item Relations] is a plugin for [Omeka] that lets you define relations between
+items. For example, you can make one item a part of another item, where
+"part of" is the relation. You can also make one item a "reproduction of" or a
+"translation of" another item.
+
+We've bundled the plugin with common relations derived from several formal
+vocabularies, like Dublin Core and FRBR. You can use these or you could populate
+a custom vocabulary with the relations needed in your archive. You could, for
+example, define custom relations like "is parent of", "is better than", and
+"fits within".
+
+See http://omeka.org/codex/Plugins/ItemRelations for more info.
+
+This fork adds a quick visual selector and made the item relations themable.
+
+
+Installation
+------------
+
+Uncompress files and rename plugin folder "ItemRelations".
+
+Then install it like any other Omeka plugin and follow the config instructions.
+
+
+Warning
+-------
+
+Use it at your own risk.
+
+It's always recommended to backup your files and database regularly so you can
+roll back if needed.
+
+
+Troubleshooting
+---------------
+
+See online [plugin issues] and [fork issues].
+
+
+License
+-------
+
+This plugin is published under [GNU/GPL].
+
+This program is free software; you can redistribute it and/or modify it under
+the terms of the GNU General Public License as published by the Free Software
+Foundation; either version 3 of the License, or (at your option) any later
+version.
+
+This program is distributed in the hope that it will be useful, but WITHOUT
+ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
+details.
+
+You should have received a copy of the GNU General Public License along with
+this program; if not, write to the Free Software Foundation, Inc.,
+51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
+
+
+Contact
+-------
+
+Current maintainers:
+
+* [Center for History & New Media]
+* Gero Zahn (see [GerZah])
+* Michael Slone (see [cokernel](https://github.com/cokernel))
+* Daniel Berthereau (see [Daniel-KM])
+
+
+Copyright
+---------
+
+* Copyright Center for History and New Media, 2011-2015
+* Copyright Michael Slone, 2015
+* Copyright Gero Zahn, 2015-2016
+* Copyright Daniel Berthereau, 2015-2016
+
+
+[Item Relations]: https://github.com/omeka/plugin-ItemRelations
+[Omeka]: https://omeka.org
+[plugin issues]: https://github.com/omeka/plugin-ItemRelations/issues
+[fork issues]: https://github.com/Daniel-KM/ItemRelations/issues
+[GNU/GPL]: https://www.gnu.org/licenses/gpl-3.0.html
+[Center for History & New Media]: http://chnm.gmu.edu
+[GerZah]: https://github.com/GerZah
+[Daniel-KM]: https://github.com/Daniel-KM "Daniel Berthereau"

controllers/LookupController.php

@@ -0,0 +1,213 @@
+<?php
+/**
+ * Item Relations
+ * LookupController
+ * @copyright 2015 Michael Slone
+ * @license http://www.gnu.org/licenses/gpl-3.0.txt GNU GPLv3
+ */
+
+/**
+ * Lookup controller.
+ */
+class ItemRelations_LookupController extends Omeka_Controller_AbstractActionController
+{
+    public function indexAction()
+    {
+        // error_log(microtime());
+        $db = get_db();
+
+        if (!$this->hasParam('subject_id')) {
+            $this->setParam('subject_id', -1);
+        }
+        if (!$this->hasParam('partial')) {
+            $this->setParam('partial', '');
+        }
+        if (!$this->hasParam('id_limit')) {
+            $this->setParam('id_limit', '');
+        }
+        if (!$this->hasParam('item_type')) {
+            $this->setParam('item_type', -1);
+        }
+        if (!$this->hasParam('collection')) {
+            $this->setParam('collection', -1);
+        }
+        if (!$this->hasParam('sort')) {
+            $this->setParam('sort', 'mod_desc');
+        }
+        if (!$this->hasParam('page')) {
+            $this->setParam('page', 0);
+        }
+        if (!$this->hasParam('per_page')) {
+            $this->setParam('per_page', 15);
+        }
+
+        $subject_id = intval($this->_getParam('subject_id'));
+        $where_subject_id = '';
+        if ($subject_id > 0) {
+            $where_subject_id = "AND items.id != $subject_id";
+        }
+
+        $partial = preg_replace('/[^ \.,\!\?\p{L}\p{N}\p{Mc}]/ui', '', $this->_getParam('partial'));
+        $where_text = '';
+        if (strlen($partial) > 0) {
+            $where_text = 'AND text RLIKE ' . $db->quote($partial);
+        }
+
+        $where_id_limit = '';
+        if (preg_match('/\s*(\d+)(?:-(\d+))?\s*/', $this->getParam('id_limit'), $matches)) {
+            $fromId = (integer) $matches[1];
+            $toId = (integer) @$matches[2];
+            if (!$toId) {
+                $toId = $fromId;
+            }
+            if ($fromId > $toId) {
+                $tmpId = $toId;
+                $toId = $fromId;
+                $fromId = $tmpId;
+            }
+            $where_id_limit = "AND items.id BETWEEN $fromId AND $toId";
+        }
+
+        $item_type = intval($this->_getParam('item_type'));
+        $where_item_type = '';
+        if ($item_type > 0) {
+            $where_item_type = "AND items.item_type_id = $item_type";
+        }
+
+        $collection = intval($this->_getParam('collection'));
+        $where_collection = '';
+        if ($collection > 0) {
+            $where_collection = "AND items.collection_id = $collection";
+        }
+
+        $per_page = intval($this->_getParam('per_page'));
+        $page = intval($this->_getParam('page'));
+        $offset = $page * $per_page;
+
+        $order_clause = 'ORDER BY items.item_type_id ASC, text ASC';
+        switch ($this->_getParam('sort')) {
+        case 'mod_desc':
+            $order_clause = 'ORDER BY UNIX_TIMESTAMP(modified) DESC, items.item_type_id ASC, text ASC';
+            break;
+        case 'mod_asc':
+            $order_clause = 'ORDER BY UNIX_TIMESTAMP(modified) ASC, items.item_type_id ASC, text ASC';
+            break;
+        case 'alpha_desc':
+            $order_clause = 'ORDER BY items.item_type_id ASC, text DESC';
+            break;
+        case 'alpha_asc':
+            $order_clause = 'ORDER BY items.item_type_id ASC, text ASC';
+            break;
+        default:
+            /* do nothing */
+            break;
+        }
+
+        $titleId = 50;
+        $query = <<<QCOUNT
+SELECT count(*) AS count
+FROM {$db->Item} items
+LEFT JOIN {$db->Element_Texts} elementtexts
+ON (items.id = elementtexts.record_id) AND (elementtexts.record_type = 'Item')
+WHERE elementtexts.element_id = $titleId
+$where_subject_id
+$where_item_type
+$where_collection
+$where_text
+$where_id_limit
+GROUP BY elementtexts.record_id
+QCOUNT;
+        $m_count = count($db->fetchAll($query));
+
+        $max_page = floor($m_count / $per_page);
+        if ($page > $max_page) {
+            $page = $max_page;
+            $offset = $page * $per_page;
+        }
+
+        $query = <<<QUERY
+SELECT items.id AS id, text
+FROM {$db->Item} items
+LEFT JOIN {$db->Element_Texts} elementtexts
+ON (items.id = elementtexts.record_id) AND (elementtexts.record_type = 'Item')
+WHERE elementtexts.element_id = $titleId
+$where_subject_id
+$where_item_type
+$where_collection
+$where_text
+$where_id_limit
+GROUP BY elementtexts.record_id
+$order_clause
+LIMIT $per_page
+OFFSET $offset
+QUERY;
+        $items = $db->fetchAll($query);
+        $m_items = array();
+
+        foreach ($items as $item) {
+            $m_items[] = array(
+                'value' => $item['id'],
+                'label' => $item['text'],
+            );
+        }
+
+        $metadata = array(
+            'count' => $m_count,
+            'items' => $m_items,
+        );
+
+        $this->_helper->json($metadata);
+    }
+
+    public function listItemTypesAction()
+    {
+        $itemTypesList = array(
+            '' => '- ' . __('All') . ' -',
+        );
+        $itemTypesList += $this->_getUsedItemTypes();
+        // Convert to a pseudo-associative array to keep order of ids.
+        $json = array(
+            'id' => array_keys($itemTypesList),
+            'label' => array_values($itemTypesList),
+        );
+        $this->_helper->json($json);
+    }
+
+    public function listCollectionsAction()
+    {
+        $collections = get_table_options('Collection');
+        // Convert to a pseudo-associative array to keep order of ids.
+        $json = array(
+            'id' => array_keys($collections),
+            'label' => array_values($collections),
+        );
+        $this->_helper->json($json);
+    }
+
+    /**
+     * Get the list of used item types for select form.
+     *
+     * @return array
+     */
+    protected function _getUsedItemTypes()
+    {
+        $db = get_db();
+
+        $itemTypesTable = $db->getTable('ItemType');
+        $itemTypesAlias = $itemTypesTable->getTableAlias();
+
+        $select = $itemTypesTable->getSelect()
+            ->reset(Zend_Db_Select::COLUMNS)
+            ->from(array(), array($itemTypesAlias . '.id', $itemTypesAlias . '.name'))
+            ->joinInner(array('items' => $db->Item), "items.item_type_id = $itemTypesAlias.id", array())
+            ->group($itemTypesAlias . '.id')
+            ->order($itemTypesAlias . '.name ASC');
+
+        $permissions = new Omeka_Db_Select_PublicPermissions('Items');
+        $permissions->apply($select, 'items');
+
+        $itemTypes = $db->fetchPairs($select);
+
+        return $itemTypes;
+    }
+}