PHPackages arraypress/wp-register-addons - 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. arraypress/wp-register-addons ActiveLibrary[Utility & Helpers](/categories/utility) arraypress/wp-register-addons ============================= A declarative WordPress add-ons page registration system for showcasing pro extensions and features 18PHP Since Mar 2Pushed 2mo agoCompare [ Source](https://github.com/arraypress/wp-register-addons)[ Packagist](https://packagist.org/packages/arraypress/wp-register-addons)[ RSS](/packages/arraypress-wp-register-addons/feed)WikiDiscussions main Synced 1mo ago READMEChangelogDependenciesVersions (1)Used By (0) WordPress Add-ons Page ====================== [](#wordpress-add-ons-page) A declarative system for registering WordPress admin add-ons showcase pages. Display available extensions, pro features, and premium add-ons in a responsive card grid with automatic plugin status detection. Installation ------------ [](#installation) ``` composer require arraypress/wp-register-addons ``` Quick Start ----------- [](#quick-start) ``` register_addons_page( 'my-plugin-addons', [ 'page_title' => __( 'Add-ons', 'myplugin' ), 'menu_title' => __( 'Add-ons', 'myplugin' ), 'menu_slug' => 'my-plugin-addons', 'parent_slug' => 'my-plugin', 'capability' => 'manage_options', 'logo' => plugin_dir_url( __FILE__ ) . 'assets/logo.png', 'pricing_url' => 'https://yoursite.com/pricing/', 'categories' => [ 'payments' => __( 'Payments', 'myplugin' ), 'marketing' => __( 'Marketing', 'myplugin' ), ], 'addons' => [ 'stripe' => [ 'title' => __( 'Stripe Connect', 'myplugin' ), 'description' => __( 'Accept payments with Stripe Connect.', 'myplugin' ), 'image' => plugin_dir_url( __FILE__ ) . 'assets/addons/stripe.png', 'plugin' => 'myplugin-stripe/myplugin-stripe.php', 'url' => 'https://yoursite.com/addons/stripe/', 'category' => 'payments', 'badge' => 'popular', ], ], ] ); ``` That's it — the menu page, card grid, category filters, search, and plugin status detection are handled automatically. Configuration Reference ----------------------- [](#configuration-reference) ``` register_addons_page( 'page_id', [ // Menu Registration 'page_title' => 'Add-ons', // Page title tag text 'menu_title' => 'Add-ons', // Menu item text 'menu_slug' => 'my-addons', // Admin page slug 'parent_slug' => '', // Parent menu slug (empty = top-level) 'capability' => 'manage_options', // Capability required to view 'icon' => 'dashicons-admin-plugins', // Dashicon (top-level only) 'position' => null, // Menu position (top-level only) // Conditional Display 'show_if' => callable|null, // Return false to hide the menu entirely // Header 'logo' => '', // URL to logo image 'header_title' => '', // Override header title 'header_badge' => '', // Badge next to title // Pro Upsell Banner 'pricing_url' => '', // URL to pricing page (empty = no banner) 'pricing_text' => '', // Banner headline 'pricing_description' => '', // Banner subtext // Categories 'categories' => [], // key => label pairs for filter tabs // Add-ons 'addons' => [], // Add-on definitions (see below) // Display 'searchable' => true, // Show search box 'columns' => 3, // Grid columns (2, 3, or 4) 'body_class' => '', // Additional CSS body class // Colors (override any CSS custom property) 'colors' => [], // key => value pairs (see Colors section) // Labels 'labels' => [ 'search' => 'Search add-ons...', 'all' => 'All', 'active' => 'Active', 'installed' => 'Activate', 'available' => 'Get This Add-on', 'feature' => 'Learn More', 'not_found' => 'No add-ons found matching your search.', ], ] ); ``` Conditional Visibility ---------------------- [](#conditional-visibility) Hide the add-ons page when a pro license is active: ``` register_addons_page( 'my-plugin-addons', [ 'show_if' => function() { return ! my_plugin_has_pro_license(); }, // ... ] ); ``` When the callback returns `false`, the menu page is never registered. Add-on Definitions ------------------ [](#add-on-definitions) Each add-on supports the following options: ``` 'addons' => [ 'stripe-connect' => [ 'title' => 'Stripe Connect', // Display name (required) 'description' => 'Accept marketplace payments.', // Card description 'image' => 'https://.../stripe.png', // Card image URL 'background' => '#f0f0ff', // Image area background (color or gradient) 'icon' => 'dashicons-cart', // Fallback dashicon (if no image) 'plugin' => 'my-stripe/my-stripe.php', // Plugin basename for auto-detection 'url' => 'https://yoursite.com/...', // Purchase/info URL 'category' => 'payments', // Category key for filtering 'badge' => 'popular', // Badge label (see Badges) 'type' => 'plugin', // 'plugin' or 'feature' 'status' => null, // Override: 'active', 'installed', 'available' ], ], ``` ### Auto-Detection [](#auto-detection) When a `plugin` basename is provided, the library automatically detects the add-on's status: StatusConditionCard Action**Active**Plugin is installed and activatedGreen checkmark**Installed**Plugin exists but is not active"Activate" button**Available**Plugin is not installed"Get This Add-on"The "Activate" button works directly from the add-ons page with nonce verification. ### Feature Type [](#feature-type) For pro features gated within the core plugin (not separate plugins): ``` 'advanced-reporting' => [ 'title' => __( 'Advanced Reporting', 'myplugin' ), 'description' => __( 'Unlock detailed analytics.', 'myplugin' ), 'type' => 'feature', 'url' => 'https://yoursite.com/pricing/', 'category' => 'reporting', ], ``` Feature-type add-ons always show as "available" with a "Learn More" link. ### Status Override [](#status-override) Force a specific status regardless of plugin detection: ``` 'coming-soon-addon' => [ 'title' => __( 'Coming Soon', 'myplugin' ), 'status' => 'available', 'badge' => 'coming_soon', ], ``` Badges ------ [](#badges) Badges appear in the top-right corner of add-on cards: Badge KeyDisplay TextColor`popular`PopularAmber`new`NewGreen`recommended`RecommendedBlue`coming_soon`Coming SoonGrayCustom stringAuto-labeledGrayCategories ---------- [](#categories) Categories render as pill-shaped filter buttons above the grid: ``` 'categories' => [ 'payments' => __( 'Payments', 'myplugin' ), 'marketing' => __( 'Marketing', 'myplugin' ), 'reporting' => __( 'Reporting', 'myplugin' ), ], ``` An "All" button is automatically included. Categories with zero add-ons are hidden. Filtering is instant (client-side) with no page reload. Search ------ [](#search) When `searchable` is enabled (default), a search box appears in the toolbar. Search is client-side with debounce and matches against add-on titles, descriptions, category labels, and badge text. Multi-word queries require all words to match. Press Escape to clear. Both category and search state are preserved in the URL (`?category=payments&s=stripe`) so filtered views are shareable and survive page refreshes. Pro Banner ---------- [](#pro-banner) The pro upsell banner displays at the top when `pricing_url` is configured: ``` register_addons_page( 'my-plugin-addons', [ 'pricing_url' => 'https://yoursite.com/pricing/', 'pricing_text' => __( 'Unlock Everything with Pro', 'myplugin' ), 'pricing_description' => __( 'Get every add-on and priority support.', 'myplugin' ), ] ); ``` Omit `pricing_url` to hide the banner entirely. Grid Columns ------------ [](#grid-columns) ``` 'columns' => 3, // 2, 3, or 4 ``` The grid is responsive — columns reduce automatically on smaller screens. Header ------ [](#header) Uses the same EDD-style header as [wp-register-tables](https://github.com/arraypress/wp-register-tables): ``` register_addons_page( 'my-plugin-addons', [ 'logo' => plugin_dir_url( __FILE__ ) . 'assets/logo.png', 'header_title' => __( 'Extensions', 'myplugin' ), 'header_badge' => [ 'text' => 'Beta', 'class' => 'badge-warning', ], ] ); ``` Colors ------ [](#colors) Override any CSS custom property via the `colors` config. Only the keys you set are output as inline styles — everything else falls back to the built-in defaults. ``` register_addons_page( 'my-plugin-addons', [ 'colors' => [ 'accent' => '#6366f1', 'accent_hover' => '#4f46e5', 'pro_bg' => 'linear-gradient(135deg, #4f46e5 0%, #7c3aed 100%)', ], ] ); ``` Available keys: KeyCSS VariableDefault`accent``--ao-accent``#2271b1``accent_hover``--ao-accent-hover``#135e96``success``--ao-success``#00a32a``text_primary``--ao-text-primary``#1d2327``text_secondary``--ao-text-secondary``#646970``text_muted``--ao-text-muted``#a7aaad``border``--ao-border``#c3c4c7``border_light``--ao-border-light``#e0e0e0``bg_white``--ao-bg-white``#fff``bg_subtle``--ao-bg-subtle``#f6f7f7``image_bg``--ao-image-bg``#f6f7f7``pro_bg``--ao-pro-bg`Gradient (blue)`pro_text``--ao-pro-text``#fff``badge_popular_bg``--ao-badge-popular-bg``#fcf0e3``badge_popular_text``--ao-badge-popular-text``#9a6700``badge_new_bg``--ao-badge-new-bg``#edfaef``badge_new_text``--ao-badge-new-text``#1a7a2e``badge_recommended_bg``--ao-badge-recommended-bg``#e5f0fa``badge_recommended_text``--ao-badge-recommended-text``#1d4ed8``badge_coming_soon_bg``--ao-badge-coming-soon-bg``#f0f0f1``badge_coming_soon_text``--ao-badge-coming-soon-text``#50575e``radius``--ao-radius``6px``radius_lg``--ao-radius-lg``8px`Values accept any valid CSS — colors, gradients, or size units depending on the property. Body Classes ------------ [](#body-classes) - `addons-page` — added to all add-ons pages - `addons-page-{id}` — page-specific class - Custom class from the `body_class` config option Hooks ----- [](#hooks) ### Actions [](#actions) ``` // Before/after grid renders add_action( 'arraypress_before_render_addons', fn( $id, $config ) => null, 10, 2 ); add_action( 'arraypress_before_render_addons_{page_id}', fn( $config ) => null, 10, 1 ); add_action( 'arraypress_after_render_addons', fn( $id, $config ) => null, 10, 2 ); add_action( 'arraypress_after_render_addons_{page_id}', fn( $config ) => null, 10, 1 ); ``` Complete Example ---------------- [](#complete-example) ``` register_addons_page( 'sugarcart-addons', [ // Menu 'page_title' => __( 'Add-ons', 'sugarcart' ), 'menu_title' => __( 'Add-ons', 'sugarcart' ), 'parent_slug' => 'sugarcart', 'capability' => 'manage_options', // Conditional visibility 'show_if' => function() { return ! sugarcart_has_pro_license(); }, // Header 'logo' => plugin_dir_url( __FILE__ ) . 'assets/logo.png', 'header_title' => __( 'Add-ons', 'sugarcart' ), // Pro banner 'pricing_url' => 'https://sugarcart.com/pricing/', 'pricing_text' => __( 'Get All Add-ons with SugarCart Pro', 'sugarcart' ), 'pricing_description' => __( 'Every add-on, priority support, and all future extensions.', 'sugarcart' ), // Categories 'categories' => [ 'payments' => __( 'Payments', 'sugarcart' ), 'emails' => __( 'Email', 'sugarcart' ), 'tools' => __( 'Tools', 'sugarcart' ), ], // Add-ons 'addons' => [ 'stripe-connect' => [ 'title' => __( 'Stripe Connect', 'sugarcart' ), 'description' => __( 'Accept marketplace payments and split revenue.', 'sugarcart' ), 'image' => plugin_dir_url( __FILE__ ) . 'assets/addons/stripe-connect.png', 'plugin' => 'sugarcart-stripe-connect/sugarcart-stripe-connect.php', 'url' => 'https://sugarcart.com/addons/stripe-connect/', 'category' => 'payments', 'badge' => 'popular', ], 'mailchimp' => [ 'title' => __( 'Mailchimp', 'sugarcart' ), 'description' => __( 'Sync customers with your Mailchimp audience.', 'sugarcart' ), 'image' => plugin_dir_url( __FILE__ ) . 'assets/addons/mailchimp.png', 'plugin' => 'sugarcart-mailchimp/sugarcart-mailchimp.php', 'url' => 'https://sugarcart.com/addons/mailchimp/', 'category' => 'emails', 'badge' => 'new', ], 'pdf-invoices' => [ 'title' => __( 'PDF Invoices', 'sugarcart' ), 'description' => __( 'Generate and attach PDF invoices to order emails.', 'sugarcart' ), 'image' => plugin_dir_url( __FILE__ ) . 'assets/addons/pdf-invoices.png', 'plugin' => 'sugarcart-pdf-invoices/sugarcart-pdf-invoices.php', 'url' => 'https://sugarcart.com/addons/pdf-invoices/', 'category' => 'tools', ], 'advanced-analytics' => [ 'title' => __( 'Advanced Analytics', 'sugarcart' ), 'description' => __( 'Detailed revenue charts, customer insights, and exports.', 'sugarcart' ), 'type' => 'feature', 'url' => 'https://sugarcart.com/pricing/', 'category' => 'tools', 'image' => plugin_dir_url( __FILE__ ) . 'assets/addons/analytics.png', 'badge' => 'recommended', ], ], ] ); ``` Requirements ------------ [](#requirements) - PHP 7.4+ - WordPress 5.0+ - arraypress/wp-composer-assets License ------- [](#license) GPL-2.0-or-later Credits ------- [](#credits) Created by [David Sherlock](https://davidsherlock.com) at [ArrayPress](https://arraypress.com). ### Health Score 20 — LowBetter than 14% of packages Maintenance56 Moderate activity, may be stable Popularity6 Limited adoption so far Community6 Small or concentrated contributor base Maturity12 Early-stage or recently created project Bus Factor1 Top contributor holds 100% 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. ### Community Maintainers ![](https://www.gravatar.com/avatar/cd6eb8aff0903d87eb674d1ba3c5f3653899c0d7661504eb0deb7798ed86b643?d=identicon)[arraypress](/maintainers/arraypress) --- Top Contributors [![arraypress](https://avatars.githubusercontent.com/u/22668877?v=4)](https://github.com/arraypress "arraypress (8 commits)") ### Embed Badge ![Health badge](/badges/arraypress-wp-register-addons/health.svg) ``` [![Health](https://phpackages.com/badges/arraypress-wp-register-addons/health.svg)](https://phpackages.com/packages/arraypress-wp-register-addons) ``` ### Alternatives [illuminate/conditionable The Illuminate Conditionable package. 9043.1M32](/packages/illuminate-conditionable)[codingfreaks/cf-cookiemanager Manage cookies, scripts, and GDPR compliance on your Typo3 website with CodingFreaks Typo3 Cookie Manager. Customize cookie banners, streamline workflow, and enhance user experience. Ensure GDPR compliance and take control of cookie management with our Typo3 cookie management extension. Visit the official Typo3 Documentation page to learn more. 1625.8k](/packages/codingfreaks-cf-cookiemanager) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)