تفصیل
Asset Lending Manager is an open-source WordPress plugin that helps any organization manage shared physical assets and internal lending workflows.
Designed for clubs, associations, schools, public bodies, libraries, laboratories, makerspaces, and any group that loans equipment or materials to its members.
Members can browse available assets and submit loan requests, while operators and administrators can manage assignments and loan history.
Born within an association of amateur astronomers to manage telescopes and equipment, it is published as a general-purpose tool usable by any organization.
Requires the Advanced Custom Fields (ACF) plugin (free version) to store and manage asset details.
Features
- Asset and kit management (a kit is a group of items lent together as a set)
- Public browsing page with search, taxonomy filters, QR labels, and QR scanner lookup
- Loan request workflow with approval, rejection, direct assignment, and configurable cancellation of competing pending requests
- Optional contact form to send email messages to the current asset owner
- Email notifications for the main loan workflow events
- Frontend asset state management for operators, including force-return and restore flows
- Full loan history, plus a dedicated full asset history page for operators via
[almgr_asset_history] - Two user roles included: Member and Operator
- Read-only JSON REST API at
/wp-json/almgr/v1/for asset list, asset detail, member list, and member assets - Back-office Tools page (ALM Tools) with Import, Export, and Utilities tabs
- Users and assets CSV import/export, including kit components and their ACF fields in asset CSV files
- Translation-ready
Requirements
Requires the Advanced Custom Fields plugin (free version is sufficient):
The plugin registers its ACF field group automatically, so no manual field setup is needed.
Loan Workflow
- A member browses the available assets.
- A loan request is submitted for a selected asset.
- Notification emails are sent to the requester and, when applicable, to the current owner.
- The current owner can approve or reject the request.
- On approval, the asset is marked as on loan and the new borrower is recorded.
- Operators and admins can also directly assign any asset that is not retired or under maintenance, without a prior request (when direct assignment is enabled).
- Operators can force-return an on-loan asset to available, or restore an asset from maintenance or retired back to available.
- All decisions, assignments, and state changes are recorded in loan history.
Credits
This plugin bundles the following third-party JavaScript libraries:
- qrcode-generator by Kazuhiko Arase (http://www.d-project.com/), MIT License
- jsQR by cozmo (https://github.com/cozmo/jsQR), Apache License 2.0
Both licenses are compatible with GPLv2 or later. License files are included in assets/js/vendor/.
سکرین شاٹاں





انسٹال کرݨ
- Install and activate the Advanced Custom Fields (ACF) plugin (free version is enough): https://wordpress.org/plugins/advanced-custom-fields/ The plugin registers its ACF field group automatically. No manual ACF setup is required.
- In WordPress admin, go to Plugins > Add New > Upload Plugin.
- Upload the plugin ZIP file, click Install Now, then Activate. Classic themes:
- Asset pages are served automatically — no shortcodes required:
/asset/— asset catalog with search and filters/asset/asset-name/— single asset detail page
- If
/asset/returns 404, go to Settings > Permalinks and click Save Changes once. - The full asset history page is not automatic. Create a normal WordPress page with the
[almgr_asset_history]shortcode and assign it in ALM > Settings > Frontend as Asset history page.
Block themes:
4. Block themes do not support automatic PHP template overrides. Create three pages manually:
* Add [almgr_asset_list] to a page — this is your asset catalog.
* Add [almgr_asset_view] to a second page — this is your asset detail view.
* Add [almgr_asset_history] to a third page — this is your full asset history page for operators.
5. In ALM > Settings > Frontend, set “Asset archive page”, “Asset detail page”, and “Asset history page” to the pages you just created. This ensures all asset and history links point to the correct pages.
6. Optionally configure email sender settings in wp-admin under ALM > Settings.
ہرہک دے سوال
-
Who is this plugin for?
-
Any organization that manages a shared pool of physical objects: associations, schools, public bodies, libraries, laboratories, makerspaces, sports clubs, and more.
The plugin was originally created for an association of amateur astronomers but is designed to be generic and suitable for any context. -
Does this plugin require Advanced Custom Fields?
-
Yes. ACF (free version) is required to store and retrieve custom asset fields. The plugin will display an admin notice if ACF is not active.
-
Does this plugin manage physical delivery of assets?
-
No. Asset delivery and handover are handled offline. The plugin tracks requests and assignments only.
-
Is there a settings page in wp-admin?
-
Yes. Under the ALM menu in wp-admin you can configure the email sender, loan rules (maximum active loans per member, message length limits), and other workflow options.
-
Which shortcodes are available and when should I use them?
-
The plugin provides three shortcodes:
[almgr_asset_list] for the asset catalog,
[almgr_asset_view] for the single asset detail view,
and[almgr_asset_history]for the full asset history page (operator-only).
On classic themes, catalog and detail pages are usually served automatically, so the history shortcode is the one most commonly needed.
On block themes, create and assign all three shortcode pages manually in ALM > Settings > Frontend. -
Is the plugin translation-ready?
-
Yes. English and Italian are included out of the box. Other languages can be added using standard WordPress translation tools.
-
What data is removed when the plugin is uninstalled?
-
Uninstalling the plugin removes the plugin settings, the loan request history, the pending loan requests, and the custom user roles.
By default, your asset inventory (posts and their data) is preserved.
If you want to remove all plugin data, defineALMGR_REMOVE_ALL_DATAastrueinwp-config.phpbefore uninstalling. -
What is the difference between an asset and a kit?
-
An asset is a single physical item (for example, a telescope, a book, or a camera). A kit is a collection of items that are lent together as a group (for example, a telescope with its eyepieces and carrying case). Managing kits allows you to track all components under a single loan request.
-
Can multiple members request the same asset at the same time?
-
Yes. Multiple members can submit requests for the same asset simultaneously. By default, when a request is approved or the asset is directly assigned, all other pending requests for that asset are automatically canceled (this behavior is configurable), and requesters are notified by email when notifications are enabled.
-
Do I need a developer to set up this plugin?
-
On classic themes, basic setup usually only requires installing the plugin and activating ACF; asset pages are served automatically, except for the optional full asset history page. On block themes, three shortcode pages must be created manually and assigned in the plugin settings: catalog, asset detail, and full asset history.
ریویو
There are no reviews for this plugin.
Contributors & Developers
“Asset Lending Manager” is open source software. The following people have contributed to this plugin.
حصہ پاوݨ آلے“Asset Lending Manager” دا آپݨی زبان وچ ترجمہ کرو۔
ڈیویلپمنٹ وچ دلچسپی ہے؟
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
تبدیلی لاگ
For full release notes see CHANGELOG.md.
0.3.0
- Added: full asset history page for operators via
[almgr_asset_history]. - Added: optional contact form to send email messages to the current asset owner.
- Fixed: kit loan approval, direct assignment, and state changes now affect only eligible components; excluded components are skipped safely and reported to the operator.
- Fixed: maintenance/restore kit behavior and ACF write handling are now more robust and consistent.
- Fixed: operator actions (direct assignment, state change, restore) now reject non-published assets.
- Fixed: asset list search field no longer collides with the WordPress reserved search query variable.
0.2.3
- Fixed: WordPress 7.0 compatibility check, minor documentation corrections, and a small admin CSS adjustment.
0.2.2
- Security: migrated the REST API to native WordPress REST API routes and removed custom authentication logic.
- Fixed: operators can upload and manage images from the Media Library.
0.2.1
- Added: Tools page with users/assets CSV import-export and utilities.
- Added: notification policy settings and full-data uninstall constant.
- Changed: internal
alm_identifiers and ACF storage keys migrated to thealmgr_prefix. - Fixed/Security: operators can approve requests without a current owner; additional hardening from code audit.
0.1.1
- Added: read-only JSON REST API and dedicated REST API settings tab.
- Security: added resource-status checks on all AJAX endpoints.
0.1.0
- First public release with asset and kit management, full loan workflow, role-based access control, email notifications, loan history, frontend browsing, QR support, asset state management, translations, and settings page.
