PHPackages qcovery/availability-plus - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. qcovery/availability-plus ActiveQcovery-module[Utility & Helpers](/categories/utility) qcovery/availability-plus ========================= Display of availability information for VuFind 1.0(2y ago)01PHPPHP >=7.3 Since Mar 5Pushed 1y ago2 watchersCompare [ Source](https://github.com/qcovery/AvailabilityPlus)[ Packagist](https://packagist.org/packages/qcovery/availability-plus)[ RSS](/packages/qcovery-availability-plus/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (1)Dependencies (1)Versions (2)Used By (0) AvailabilityPlus - Module Description ===================================== [](#availabilityplus---module-description) This module tries to address the complex issue of checking and displaying availability information. The order and mode of availability checks can be configured for different Backends (Solr and Search2 have been confirmed to work) providing MARC-Data and for different media formats. It also provides a TestCase-Tool for displaying the availability information for a configured set of Index-Ids in on spot. Lastly, it provides a Debug-Tool which displays details on which checks were performed and their result. It was also an aim to be able to easily integrate different resolvers into this process and adjust their results based on configurable rules. The module works in VuFind 5 and 8, only a dependency, the RecordDriver module, has some small differences between these VuFind versions: - For VuFind 5 use module in this branch: - For VuFind 8 use module in this branch: Installation (manual steps) --------------------------- [](#installation-manual-steps) Currently only a manual installation is possible. The module will be made available as a Composer module in the future. - This branch needs to be cloned into a separate folder and then the files copied or linked in the vufind folder of the system in which AvailabilityPlus is to be integrated. - Required Module: [RecordDriver from this branch](../RecordDriver) - Besides the Module Package these files are required: - AvailabilityPlus-Configuration [../../config/vufind](../../config/vufind) all files starting with availabilityplus - AvailabilityPlus-Theme [../../themes/availabilityplus](../../themes/availabilityplus) - AvailabilityPlus-Translations [languages](languages/) need to be added to the respective language files - Changes to PluginManager.php-files might be required: References to GetItemStatuses and GetItemStatuses Factory need to be changed to the AvailabilityPlus Namespace - Changes to Theme config: the availabilityplus theme needs to be added as a mixin - The modules RecordDriver and AvailabilityPlus need to be added to the modules used by VuFind in the Apache configuration. AvailabilityPlus needs to be specified after RecordDriver as it depends on it. - If a custom js/check\_item\_statuses.js is in the Theme used, then it needs to be removed. - Add rendering of availabilityplus-Templates - in lists: [availabilityplus-result-list.phtml](../../themes/availabilityplus/templates/RecordDriver/SolrDefault/availabilityplus-result-list.phtml) - in record view (preferably on the right hand side): [availabilityplus-view.phtml](../themes/availabilityplus/templates/record/availabilityplus-view.phtml) - If your system does not use `/vufind` as root in the URL path, then it might be necessary to remove `/vufind´ in some configuration, template and module files. In some case the path is still hard-coded. An alternative could be to add a rewrite rule in your web server configuration. Example for rendering: ``` ``` Module configuration -------------------- [](#module-configuration) Configuration files in this module: - Order and mode of availability checks: [availabilityplus.ini](../../config/vufind/availabilityplus.ini) - MARC-Data used for availability checks and as parameter for resolvers: [availabilityplus.yaml](../../config/vufind/availabilityplus.yaml) - TestCases: [availabilityplus-testcases.yaml](../../config/vufind/availabilityplus-testcases.yaml) - Resolver: - Basic configuration, such as base url, parameters and, for DAIA only, grouping: [availabilityplus-resolver.ini](../../config/vufind/availabilityplus-resolver.ini) - Rules for adjusting resolver results, one file per resolver, with the name pattern availabilityplus-resolver-{name of resolver}.yaml, e.g. [availabilityplus-resolver-DAIA.yaml](../../config/vufind/availabilityplus-resolver-DAIA.yaml) TestCase-Tool ------------- [](#testcase-tool) The TestCase-Tool was developed to provide one page which displays the availability information for a set of configured Index-IDs. The configuration can also included a description or an expected result in HTML against which the actual result is being checked. An example how the TestCase-Tool works, can be found \[here\] (). The TestCase-Tool can be configured [here](../../config/vufind/availabilityplus-testcases.yaml). The yaml-File provides comments on how to structure the configuration and an example. The TestCase-Tool also provides links to the Debug-Tool. **It might be necessary to remove `/vufind` in URL paths set in [testcases.phtml](../../themes/availabilityplus/templates/availabilityplus/testcases.phtml), if your system is set up without using `/vufind`.** Debug-Tool ---------- [](#debug-tool) The Debug-Tool was developed to display detailed information about which availability checks were performed and about their results. It can be accessed via the TestCase-Tool, by adding `debug_ap=true` as URL-parameter or by using `/vufind/AvailabilityPlus/Debug/{id}` (or `/AvailabilityPlus/Debug/{id}`). An example can be found [here](https://hilkat.uni-hildesheim.de/vufind/AvailabilityPlus/Debug/389600296?list=1&driver=Solr). **It might be necessary to remove `/vufind` in URL paths set in [debug.phtml](../../themes/availabilityplus/templates/availabilityplus/debug.phtml), if your system is set up without using `/vufind`.** ToDos ----- [](#todos) - Create Composer module - remove hard-coded references to `/vufind/...`, so URLs are generated independently of whether `/vufind` is used with URL path - rework MARC configuration in [../../config/vufind/availabilityplus.yaml](../../config/vufind/availabilityplus.yaml) to be more generic, currently it is based on the MARC structure used by [K10plus-Zentral](https://github.com/gbv/findex-config/tree/master/SolrCloud) - Rework DAIA configuration and move grouping from templates to DAIA-Resolver - Change Resolver interface to allow for providing MARC-Data for configuration or rules based on MARC-Data - Add A+ parsing for SFX-Resolver - Add CrossRef to get DOIs to pass on to Unpaywall - rework availabilityplus-result-list.phtml and availabilityplus-result-list.phtml, only one Template might be necessary, potentially they might not be needed if parameter values can be obtained directly in [GetItemStatuses.php](src/AvailabilityPlus/AjaxHandler/GetItemStatuses.php#L94) - rework backend/source/driver handling to make sure it can be used with different backends, although at this point, the module will not work with backends not providing MARC-Data ### Health Score 19 — LowBetter than 10% of packages Maintenance26 Infrequent updates — may be unmaintained Popularity1 Limited adoption so far Community10 Small or concentrated contributor base Maturity36 Early-stage or recently created project Bus Factor1 Top contributor holds 66.7% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Unknown Total 1 Last Release 802d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/9fe43ec496d49670246b295d6a3d7cc77d077406ada8ec734a86fa8aea2f5e33?d=identicon)[Qcovery](/maintainers/Qcovery) --- Top Contributors [![jschultze](https://avatars.githubusercontent.com/u/4047699?v=4)](https://github.com/jschultze "jschultze (2 commits)")[![oliver-stoehr](https://avatars.githubusercontent.com/u/32509444?v=4)](https://github.com/oliver-stoehr "oliver-stoehr (1 commits)") ### Embed Badge ![Health badge](/badges/qcovery-availability-plus/health.svg) ``` [![Health](https://phpackages.com/badges/qcovery-availability-plus/health.svg)](https://phpackages.com/packages/qcovery-availability-plus) ``` ### Alternatives [aimeos/aimeos-base Aimeos base layer for abstracting from host environments 2.1k134.0k1](/packages/aimeos-aimeos-base)[microweber/screen A PHP Class to interact with PhantomJs and capture screenshot of a webpage 632226.0k1](/packages/microweber-screen)[fuel/docs FuelPHP 1.x Documenataion 166542.3k4](/packages/fuel-docs)[fof/user-directory The permission based public user directory extension for your Flarum forum. 2789.7k5](/packages/fof-user-directory) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)