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.
Version 1.0.1 adds a selector for two ARK link notations:
- Classic —
/ark:/10951/arca2026 - Modern —
/ark:10951/arca2026 - Both — either notation resolves to the same destination URL.
Both notations accept an optional qualifier as a third segment (/ark:/NAAN/name/qualifier and /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 both ARK notations, selectable from the settings screen.
- Choice between classic (
ark:/NAAN), modern (ark:NAAN) or both at the same time. - 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 and settings.
Español
ARCA del Mar Caribe convierte un sitio WordPress en un resolvedor local de identificadores ARK. Admite la forma clásica con barra /ark:/NAAN/nombre/cualificador y la forma moderna sin barra /ark:NAAN/nombre/cualificador, elegibles por separado o activas al mismo tiempo. 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.
El formato del enlace se elige en la misma pantalla de ajustes: Clásico, Moderno o Ambos. Con Ambos, las dos notaciones resuelven al mismo destino. Cambiar el formato no altera los registros existentes.
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 notaciones, 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-Options or Content-Security-Policy headers 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.
Which ARK notation should I use?
Go to Settings > ARCA del Mar Caribe and choose the link format. Classic uses ark:/NAAN, Modern uses ark:NAAN, and Both accepts either notation for the same record. Both notations are always registered as rewrite rules; the chosen format decides which ones resolve.
Why does the other ARK notation return a 404?
Only the notations enabled in the settings resolve. With Classic selected, ark:NAAN requests return a 404, and the reverse with Modern. Choose Both to keep both notations working at the same time.
Does it support multi-segment ARK suffixes?
This version supports one optional qualifier segment after the name, in both notations (/ark:/NAAN/name/qualifier and /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_options capability 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.
Changelog
1.0.1
- Added a link format selector for the ARK notation: classic (
ark:/NAAN), modern (ark:NAAN) or both. - With “Both”, the two notations resolve to the same destination URL for every record.
- Both notations are always registered as rewrite rules; the selected format decides which ones resolve.
- Rewrite rules are flushed automatically once after updating the plugin.
- Packaged the CSS and JavaScript files inside
assets/cssandassets/jsso they match the enqueued paths.
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.