CardanoPress includes many templates for front-end layouts. You can override these safely in your theme or child theme. This gives you control of the look and feel without touching plugin files.
How Overrides Work #
When loading a template, CardanoPress checks the theme folder first. If a matching file exists there, it uses it instead of the plugin default.
- Plugin templates:
wp-content/plugins/cardanopress/templates/ - Theme override path:
wp-content/themes/<your-theme>/cardanopress/
Example Override #
To customise the wallet connect modal:
Copy:
wp-content/plugins/cardanopress/templates/modal-connect.php
To:
wp-content/themes/your-theme/cardanopress/modal-connect.php
Best Practices #
- Only copy files you need to change.
- Keep essential data attributes in place for scripts to work.
- After updating the plugin, compare your overrides with any new template versions.
WASM Update #
No .htaccess rule is needed for WASM in v1.30.0+. WASM is now served remotely. Remove any old MIME rules you may have added.
Template List #
Here’s the full list of templates and their override paths. Place the file in the theme override path with the same folder structure.
Page Templates #
| Name | Purpose | Plugin Path | Theme Path |
|---|---|---|---|
| Collection.php | Displays an asset or NFT collection. | templates/page/Collection.php | cardanopress/page/Collection.php |
| Dashboard.php | User dashboard for CardanoPress features. | templates/page/Dashboard.php | cardanopress/page/Dashboard.php |
| Delegation.php | Stake pool delegation flow. | templates/page/Delegation.php | cardanopress/page/Delegation.php |
| Payment.php | Payment form page. | templates/page/Payment.php | cardanopress/page/Payment.php |
| Split.php | Split payment form page. | templates/page/Split.php | cardanopress/page/Split.php |
Global Layouts #
| Name | Purpose | Plugin Path | Theme Path |
|---|---|---|---|
| collection-list.php | List of collection items. | templates/collection-list.php | cardanopress/collection-list.php |
| menu-dropdown.php | Profile menu dropdown. | templates/menu-dropdown.php | cardanopress/menu-dropdown.php |
| modal-connect.php | Wallet connect modal. | templates/modal-connect.php | cardanopress/modal-connect.php |
| notices-handler.php | Displays system notices. | templates/notices-handler.php | cardanopress/notices-handler.php |
| payment-form.php | Standalone payment form layout. | templates/payment-form.php | cardanopress/payment-form.php |
| pool-delegation.php | Standalone pool delegation layout. | templates/pool-delegation.php | cardanopress/pool-delegation.php |
| welcome-banner.php | Banner for CardanoPress pages. | templates/welcome-banner.php | cardanopress/welcome-banner.php |
Partial Templates #
Partial templates control smaller sections like buttons, modals, and profile items. Override them in cardanopress/part/ within your theme.
