Hoard Shortcuts

By Rafael Oliveira

0+ active installationsVersion 2.0.26

Turn ordinary links into amazing visual cards. Like modern buttons with text, image, alignment, order and more – all individually adjustable.

Description

Hoard Shortcuts is a WordPress plugin that adds widgets to create shortcuts as visual cards – large buttons that can include a title, description, link, and/or background image.

You build each card your way: informational only (no link), text with a link, image with a link, title+description+image+link all together, and many other combinations.

Perfect for highlighting services, external pages, important links, and more, all in a simple and visual way.

Main features

  • Create as many shortcuts as you want — no limits.
  • Add images to cards (optional) using the WordPress Media Library.
  • Manage shortcuts through a simple, dynamic interface.
  • Reorder items directly in the widget form.
  • Choose whether links open in the same tab or in a new browser tab.
  • Text alignment options per card.
  • Five proportional button height options per card.
  • Choose how many columns to show on large screens (1–6); layout still collapses on smaller screens.
  • Search posts and pages from the link field using WordPress’s built-in internal linking AJAX (or paste any URL).
  • Simple click counts per shortcut (shown in the widget editor), with per-card or list-wide reset.
  • Export and import shortcut lists as JSON to back up or move configurations between widgets/sites.
  • Responsive layout for desktop, tablet, and mobile.
  • Compatible with keyboard navigation and accessibility features.
  • Translation ready with the text domain and no external dependencies.

Usage

  1. Add the Hoard Shortcuts widget to a WordPress widget area.
  2. Set an title for the widget (optional).
  3. Click + Add new shortcut.
  4. Fill in the shortcut’s title, description, link, and image (according to your needs).
  5. Save the widget.

Installation

  1. Upload the hoard-shortcuts folder to the /wp-content/plugins/ directory.
  2. Activate the plugin through the Plugins menu in WordPress.
  3. Go to Appearance > Widgets.
  4. Add the Hoard Shortcuts widget to a widget area.
  5. Configure your shortcut cards, reorder them if needed, and save the widget.

FAQ

Can I use the plugin without images?

Yes. Images are optional for every shortcut card.

Can I reorder the shortcuts?

Yes. Each item includes Move up and Move down buttons in the widget form.

Can links open in a new tab?

Yes. Each shortcut has its own Open link in a new tab option.

How many shortcuts can I add?

There is no hard-coded limit in the widget interface.

Is the plugin translation-ready?

Yes. The plugin loads translations from the /languages/ directory and uses the hoard-shortcuts text domain.

Does it work with modern WordPress widget screens?

Yes. The plugin supports the classic widgets screen, the Customizer, and the block-based widgets editor where classic widgets are available.

Is custom CSS on shortcut cards safe?

Custom CSS is an advanced option intended for site administrators. Saving widget settings requires the edit_theme_options capability (the same trust boundary WordPress uses for Appearance → Customize → Additional CSS). The plugin strips HTML tags and blocks known dangerous tokens (such as @import and expression(), but it does not fully sandbox arbitrary selectors. Treat custom CSS like theme Additional CSS: only grant widget-editing access to trusted users.

How do click counts work, and do they store personal data?

When a visitor clicks a linked card, the plugin increments a simple total for that shortcut (stored in a single option, never autoloaded). No IP address, user agent, or other visitor data is stored. To limit repeated requests, a very short-lived (2 seconds) transient keyed by a one-way hash of the visitor IP and shortcut ID is used and then expires. Cards without a link are not counted, and counts are only shown in the widget editor. Use Reset on a card or Reset all clicks to clear them.

Can I allow extra URL protocols (WhatsApp, SMS, etc.)?

Yes. Shortcut link URLs use WordPress’s default allowed protocols (http, https, mailto, tel, sms, and others from wp_allowed_protocols()). Extend or restrict them with:

add_filter( 'caoszone_hoard_shortcuts_allowed_url_protocols', function( $protocols ) { $protocols[] = 'whatsapp'; return $protocols; } );

Shortcut image URLs on new saves allow only http and https by default. Developers can adjust the list with caoszone_hoard_shortcuts_allowed_image_url_protocols (prefer Media Library https URLs in production).

Existing image URLs that use unsupported schemes are not deleted on upgrade or when you only edit other fields; the widget form shows a warning until you replace the image with an http/https URL.

Screenshots

Changelog

2.0.26

  • Feature milestone with no breaking changes — existing widgets and data keep working after upgrade.
  • Security hardening: conservative legacy migration, filterable URL protocol allowlists, and non-destructive handling of unsupported image URLs on re-save.
  • Added Desktop columns (1–6); existing lists default to the previous 3-column layout.
  • Added internal content search on the link field (wp-link-ajax); external and custom URLs can still be pasted.
  • Added per-shortcut click tracking, per-card/list reset, and JSON export/import for shortcut lists.
  • Documentation for the trusted-admin custom CSS model and developer protocol filters.

1.3.1

  • Kept shortcut item headers compact on mobile and shortened their numbering.
  • Automatically expanded advanced options when a shortcut has custom settings.

1.3.0

  • Added default text alignment and button height settings for the entire shortcut list.
  • Added per-shortcut options to inherit the list defaults or use custom values.

1.2.0

  • Added five proportional button height options per shortcut.

1.1.1

  • Updated the plugin for compatibility with WordPress 7.1.
  • Changed the shortcut button height to be proportional to its width.

1.1.0

  • Updated frontend shortcut card styling for a cleaner and more modern interface.

1.0.3

  • Added per-card text alignment options, including justified alignment.
  • Improved widget form spacing and option layout.

1.0.2

  • Added a dedicated widget icon for the block-based widgets editor.
  • Refined shortcut list copy in English and Portuguese.
  • Recompiled translation files for release.

1.0.1

  • Updated source strings to English for WordPress.org translation compatibility.

1.0.0

  • Initial release.
  • Visual shortcut card widget.
  • Media Library image picker.
  • Manual item ordering in the widget editor.
  • Optional open-in-new-tab setting per shortcut.
  • Empty-state placeholder for image preview.
  • Responsive frontend styles.
  • Translation-ready strings.