Advanced Search Plus (module for Omeka S)

IMPORTANT: This module is deprecated and has been replaced by the module Advanced Search and won’t be updated any more. The upgrade from it is automatic.

New versions of this module and support for Omeka S version 3.0 and above are available on GitLab, which seems to respect users and privacy better than the previous repository.

Advanced Search Plus is a module for Omeka S that add some fields to the advanced search form to make search more precise.

Added fields are:

• before/on/after creation/modification date/time of any resource
• has media (for item)
• has original
• has thumbnail
• multiple media types (for item)
• multiple media types for media (included in core since Omeka S 2.0.2 for a single value)
• visibility public/private
• media by item set

Furthermore, it adds new search query type for properties:

• start with
• end with
• in list (via api only).
• exclude one or multiple properties (except title)

Finally, an option allows to display only the used properties and classes in the advanced search form, with chosen-select.

Installation

See general end user documentation for installing a module.

• From the zip

Download the last release AdvancedSearchPlus.zip from the list of releases, and uncompress it in the modules directory.

• From the source and for development

If the module was installed from the source, rename the name of the folder of the module to AdvancedSearchPlus.

Notes

Exclude properties

To exclude properties to search in, use key except. For example, to search anywhere except in "bibo:content", that may contains ocr or full text, use this api query https://example.org/api/items?property[0][except]=bibo:content&property[0][type]=in&property[0][text]=text to search, or in internal api:

$query['property'][] = [
    'joiner' => 'and',
    'property' => '',
    'except' => $excludedFields,
    'type' => 'in',
    'text' => "text to search",
];

The excluded fields may be one or multiple property ids or terms.

The title cannot be excluded currently, because it is automatically added by the core.

Visibility

The visibility check may not working if the api url contains &is_public=&: is_public must not be a empty string. See the patch in https://github.com/omeka/omeka-s/pull/1671. This patch is integrated in module only for url, and for call to internal api.

TODO

• [x] The override of a search query with "property" should be called even with "initialize = false" in the api.

Warning

Use it at your own risk.

It’s always recommended to backup your files and your databases and to check your archives regularly so you can roll back if needed.

Troubleshooting

See online issues on the module issues page on GitLab.

License

This module is published under the CeCILL v2.1 license, compatible with GNU/GPL and approved by FSF and OSI.

This software is governed by the CeCILL license under French law and abiding by the rules of distribution of free software. You can use, modify and/ or redistribute the software under the terms of the CeCILL license as circulated by CEA, CNRS and INRIA at the following URL "http://www.cecill.info".

As a counterpart to the access to the source code and rights to copy, modify and redistribute granted by the license, users are provided only with a limited warranty and the software’s author, the holder of the economic rights, and the successive licensors have only limited liability.

In this respect, the user’s attention is drawn to the risks associated with loading, using, modifying and/or developing or reproducing the software by the user in light of its specific status of free software, that may mean that it is complicated to manipulate, and that also therefore means that it is reserved for developers and experienced professionals having in-depth computer knowledge. Users are therefore encouraged to load and test the software’s suitability as regards their requirements in conditions enabling the security of their systems and/or data to be ensured and, more generally, to use and operate it in the same conditions as regards security.

The fact that you are presently reading this means that you have had knowledge of the CeCILL license and that you accept its terms.

Copyright

• Copyright Daniel Berthereau, 2018-2021, (see Daniel-KM on GitLab)