Pages and shortcodes
The Pages tab controls which WordPress pages the plugin uses for commerce functionality. Pages are powered by shortcodes that render commerce features. Some pages use a single shortcode, others combine multiple shortcodes.
Go to Propeller > Pages in your WordPress admin to access these settings.
Page types
When you activate the plugin it creates a set of WordPress pages automatically. Each page has a type that determines its role in the storefront. The default configuration is ready to use. You can change page settings, reassign shortcodes or adjust URL slugs if needed through the Pages tab.
The available page types are:
Catalog and product pages
- Category page
- Product page
- Cluster page
- Search page
- Brand page
- Machines page
Cart and checkout pages
- Shopping cart page
- Checkout page
- Checkout summary page
- Checkout thank you page
Payment pages
- Payment check page
- Thank you page
- Payment failed page
- Payment being processed page
- Payment cancelled page
- Expired payment request page
Account pages
- My account page
- My account mobile page
- Account details page
- Addresses page
- Favorites page
- Quick order page
Order and quote pages
- Orders page
- Order details page
- Orderlist page
- Quotations page
- Quotation details page
- Invoices page
- Price request page
Purchase authorization pages
- Purchase authorizations page
- Purchase authorization requests page
- Purchase authorization thank you page
- Authorization confirmed page
Authentication pages
- Login page
- Register page
- Forgot password page
- Reset password page
- SSO Login page
Other pages
- Terms & Conditions page
Page configuration
Each page in the Pages tab has the following configuration fields:
| Field | Description |
|---|---|
| Page name | The WordPress page title. |
| Type | The page type from the dropdown. Determines the page's role in the storefront. |
| Shortcode | The shortcode assigned to render commerce content on this page. |
| Slug | The URL path for this page (for example products makes the page available at yoursite.com/products/). |
| Apply Read/Write rules | When enabled, applies Propeller's read/write permission rules to this page. |
| Is My account page | Marks this page as the main account dashboard. |
| Child of My Account | Nests this page under the account section in navigation. |
Shortcodes
Pages use shortcodes to render commerce content. The relationship is not always 1:1. Some pages combine multiple shortcodes. For example, the account dashboard can include account-recent-orders, account-recent-favorites, account-recent-invoices and purchase-authorizations-short-list, each showing a specific subset of data.
The plugin provides shortcodes for all commerce features. You can use these shortcodes on any WordPress page, not just the predefined ones. This lets you combine Propeller commerce content with regular WordPress content on the same page.
Navigation and layout
| Shortcode | Description |
|---|---|
menu | Main navigation menu |
mini-account | Compact account widget (header login/account link) |
account-menu | Account section navigation menu |
favorites-menu | Favorites icon/link for the header |
price-toggle | VAT inclusive/exclusive price switcher |
Catalog and products
| Shortcode | Description |
|---|---|
product-listing | Product listing with filtering and sorting |
product-details | Single product page |
cluster-details | Cluster (product group with variants) page |
product-slider | Product carousel/slider |
search | Search results page |
brand-listing | Brand overview page |
brand-listing-content | Brand page with product listing |
machines | Machine park overview |
Cart and checkout
| Shortcode | Description |
|---|---|
shopping-cart | Full shopping cart page |
mini-shopping-cart | Compact cart widget (header cart icon with count) |
mini-checkout-cart | Compact cart summary during checkout |
checkout | Checkout page |
checkout-summary | Order summary before placing the order |
checkout-thank-you | Order confirmation page |
quick-add-to-basket | Quick order form (add by SKU/quantity) |
Payment status
| Shortcode | Description |
|---|---|
payment-failed | Payment failed status page |
payment-processed | Payment being processed status page |
payment-cancelled | Payment cancelled status page |
payment-expired | Expired payment request page |
authorization-confirmed | Payment authorization confirmed page |
Account
| Shortcode | Description |
|---|---|
account-page | Account dashboard |
account-details | Account details with dashboard |
account-details-section | Account details section (partial) |
account-details-no-dashboard | Account details without dashboard |
account-company-name | Company name display |
account-recent-orders | Recent orders widget |
account-recent-quotations | Recent quotations widget |
account-mobile | Mobile account page |
account-addresses | Address book |
contact-companies | Company contacts overview |
Orders, quotes and invoices
| Shortcode | Description |
|---|---|
account-orders | Order history |
account-order-details | Single order detail page |
account-quotations | Quotation history |
account-invoices | Invoice history |
account-recent-invoices | Recent invoice history |
Favorites
| Shortcode | Description |
|---|---|
account-favorites | Favorites lists overview |
account-recent-favorites | Recently modified favorites lists |
Authentication
| Shortcode | Description |
|---|---|
login-page | Login form with guest checkout option (continue to order as a guest) |
login-form | Standalone login form without guest checkout option |
forgot-password-form | Forgot password form |
reset-password-form | Reset password form |
registration-form | Registration form |
sso-sign-in | Single Sign-On login |
Other
| Shortcode | Description |
|---|---|
price-request | Price request form |
purchase-authorizations | Purchase authorization overview |
purchase-authorization-requests | Purchase authorization requests |
purchase-authorization-thank-you | Purchase authorization confirmation |
purchase-authorizations-short-list | Recent purchase authorization requests |
Template customization
Each shortcode maps to a PHP template file in /plugins/propeller-ecommerce-v2/public/templates/. For example, the product-details shortcode renders through propeller-product-details.php. Templates reference partial templates in /plugins/propeller-ecommerce-v2/public/partials/ using PHP require statements via BaseController::load_template().
The plugin resolves templates in this priority order:
-
Theme override — Place files in your active theme under
propeller/templates/,propeller/partials/, etc. These take highest priority. -
Extend plugin override — Define
PROPELLER_PLUGIN_EXTEND_DIRinwp-config.phppointing to a custom plugin directory (typically in/mu-plugins/). Place files underpublic/templates/,public/partials/, etc. within that directory. -
Default plugin templates — The built-in templates in
/plugins/propeller-ecommerce-v2/public/are used as fallback.
Additionally, you can use filter hooks in custom-filters.php (placed in the extend directory) to swap partial template paths. For example, apply_filters('propel_product_gallery', ...) lets you replace the product gallery partial with your own template file.
Next steps
- Behavior and display — configure feature toggles and display options