Description
ARK (Archival Resource Key) is a persistent identifier scheme that uses the syntax ark:/NAAN/name. ARCA del Mar Caribe is a WordPress plugin that turns your site into a local ARK resolver for the slash form /ark:/NAAN/name/qualifier.
Plugin owner and copyright holder: Editorial Mar Caribe.
Unlike a plain redirect, the resolver can keep the ARK identifier in the browser address bar while displaying the target resource inside an iframe. It can also issue a standards-based HTTP 302 or 303 redirect.
Features
- Public resolver rules for
/ark:/NAAN/nameand/ark:/NAAN/name/qualifier. - Two delivery modes per identifier: embedded viewer (the address bar keeps the ARK) or HTTP 302/303 redirect.
- Admin screen under Settings > ARCA del Mar Caribe to add, edit and delete identifiers.
- Edit action that changes an existing identifier’s destination URL and delivery mode without altering its NAAN, name or qualifier.
- Validation for NAAN (five digits), assigned name and qualifier segments.
- Destination URLs restricted to http and https.
- Canonical redirects disabled for ARK requests so the identifier is preserved.
- No external services, trackers or remote requests.
- Uninstall removes the stored identifiers.
Español
ARCA del Mar Caribe convierte un sitio WordPress en un resolvedor local de identificadores ARK en la forma de barra /ark:/NAAN/nombre/cualificador. Permite mantener la URL ARK en la barra del navegador mostrando el recurso en un iframe, o redirigir con HTTP 302/303. Los identificadores se gestionan desde Ajustes > ARCA del Mar Caribe.
Cada registro existente dispone de una acción Editar URL que permite cambiar el destino y el modo de entrega sin modificar el NAAN, el nombre ni el cualificador.
Características: reglas públicas para las dos variantes de ruta, validación de NAAN y segmentos, URLs limitadas a http/https, formulario con nonces y comprobación de permisos, edición del destino de un ARK ya creado, assets cargados solo en la pantalla del plugin y limpieza de datos al desinstalar.
Installation
- Upload the
arca-del-mar-caribefolder to/wp-content/plugins/, or install the ZIP from Plugins > Add New > Upload Plugin. - Activate the plugin through the Plugins screen.
- Go to Settings > Permalinks and save the settings once so the ARK rewrite rules are registered.
- Go to Settings > ARCA del Mar Caribe and add your identifiers.
Manual installation
Extract arca-del-mar-caribe.zip and upload the resulting arca-del-mar-caribe folder to /wp-content/plugins/. Do not nest it inside another folder with the same name.
FAQ
-
Which permalink structure is required?
-
A pretty permalink structure is required (for example
/%postname%/). The ARK rules are rewrite rules and do not work with the “Plain” permalink option. -
Why does the ARK URL return a 404?
-
Check that the permalink structure is not “Plain”, that the plugin was activated after the rules were added, and that the NAAN, name and qualifier match the stored record exactly. Saving the Permalinks screen once flushes the rules.
-
The embedded view is blank or shows an error
-
Some sites send
X-Frame-OptionsorContent-Security-Policyheaders that block embedding. In that case edit the identifier and choose the HTTP redirect mode instead. -
Are redirects cached?
-
No. ARK responses send no-cache headers so changes in the target URL take effect immediately.
-
Does it support multi-segment ARK suffixes?
-
This version supports one optional qualifier segment after the name (
/ark:/NAAN/name/qualifier). Additional suffix segments are not resolved. -
How do I change the destination URL of an existing ARK?
-
Go to Settings > ARCA del Mar Caribe, click Editar URL in the row of the identifier, update the URL and save. The NAAN, name and qualifier stay unchanged; only the destination and the delivery mode are updated.
-
Is the destination URL checked?
-
The URL must use http or https. Only users with the
manage_optionscapability can create or edit identifiers, and the destination is stored by the administrator, never supplied by the visitor. Because the plugin is a public resolver, the destination may point to an external host.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“ARCA del Mar Caribe” is open source software. The following people have contributed to this plugin.
Contributors
Translate “ARCA del Mar Caribe” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
2.4.0
- Added an edit action to change the destination URL and delivery mode of an existing identifier without changing its NAAN, name or qualifier.
- The edit form preloads the current URL, mode and HTTP status.
- The embedded viewer loads its stylesheet through the WordPress enqueue API.
- Distributed under the GNU General Public License version 2 or later, with the complete official license text.
- Uses the WordPress.org text domain
arca-del-mar-caribe. - Tested with WordPress 7.1.
2.3.1
- Added the plugin access link: https://www.editorialmarcaribe.es/ark:/10951/arca2026.
2.3.0
- Renamed the plugin to ARCA del Mar Caribe.
- Changed the plugin slug, main file and text domain to
arca-del-mar-caribe. - Kept the
ark_full_resolver_slash_recordsoption so existing ARK records survive the rebrand.
2.2.0
- Fixed: license text no longer sits outside the PHP opening tag, which caused “headers already sent” errors.
- Added complete WordPress plugin headers, including
Requires PHP. - Added nonce verification and capability checks to the save and delete actions.
- Added POST/Redirect/GET to prevent duplicate submissions.
- Added sanitization callbacks, strict mode/type whitelists and URL scheme validation.
- Moved inline styles and JavaScript to enqueued assets.
- Added internationalization and escaped all output.
- Added uninstall cleanup.
- Added a canonical redirect filter for ARK requests.
2.1.0
- Initial public release with slash-form ARK resolver.