Settings Reference
This page documents every configuration option available on the PointlessPOS > Settings tab in your WordPress admin. All settings are saved to the WordPress options table and take effect immediately after saving.
Core Settings
| Setting | Type | Default | Description |
|---|---|---|---|
| API Base URL | Text | (empty) | Full base URL of your POS REST API (e.g., https://api.yourposdomain.com). All product, pricing, and inventory requests originate from this endpoint. |
| Image Base URL | Text | (empty) | Base URL where product images are hosted (e.g., https://cdn.yourposdomain.com/images). Combined with product image filenames to build full image URLs. |
| Image Fallback URL | Text | (empty) | Optional — URL for a placeholder image shown when a product has no photo. Can be a generic image hosted on your server or a CDN. |
| Cart Page | Page dropdown | (none) | The WordPress page where your shopping cart is rendered. Select an existing page from the dropdown. The floating cart button will link to this page. |
| Floating Cart Position | Select | Right | Which side of the screen the floating cart button appears. Choose Right or Left. |
| Catalog Root Page Slug | Text | (empty) | The slug of the page that contains your PointlessPOS shortcodes (e.g., catalog-listing). Used for internal routing and navigation back to your main catalog page. |
| Catalog Columns | Number (1–6) | 3 | Number of columns in the product grid on your catalog page. Higher values produce a denser layout. |
| Minimum Inventory Count | Number (0+) | 6 | Items with inventory below this threshold are hidden from advanced search results. Set to 0 to show all items regardless of stock level. |
Cart & Navigation Settings
| Setting | Type | Default | Description |
|---|---|---|---|
| Cart Style | Select | Full Page | Full Page: The floating cart button links to your configured cart page. Side Panel: Clicking the floating cart opens a slide-in overlay panel — no page navigation required. |
| Side Panel Extra Content | Text (shortcode) | (empty) | An optional shortcode rendered below the checkout button in the side panel cart. Use this to display specials, related items, or promotions. Example: [pointless_pos_price_schedules name="Specials"]. Leave blank to hide. |
| Header View Mode | Select | Categories Grid | Controls the header navigation on your catalog page. Categories Grid shows category cards. Menu View shows a department-based overlay menu with filter columns (class, style, region, etc.). Requires [pointless_pos_categories] or [pointless_pos_menu_view] shortcode on your catalog page. |
| Checkout Base URL | Text | (empty) | External checkout URL (e.g., https://your-webapp/checkout). When set, the checkout flow redirects customers to this URL to complete their order. |
Settings Backup & Restore
The plugin includes a built-in tool to export and import all PointlessPOS settings as JSON. This is useful when migrating between sites, restoring after a backup, or deploying settings to a staging environment.
The Settings Backup & Restore section appears at the bottom of the Settings tab.
Export Settings
- Scroll to the Settings Backup & Restore section
- Click Export to JSON
- A
pointless-pos-settings.jsonfile will download to your computer
The exported file contains all pointless_pos_* options from your WordPress database.
Import Settings (Paste JSON)
- Scroll to the Settings Backup & Restore section
- Paste the full JSON object into the text area
- Click Import Settings
- Confirm the overwrite prompt
Only options prefixed with pointless_pos_ will be updated. Other keys in the JSON are safely ignored.
Import Settings (Upload File)
- Scroll to the Settings Backup & Restore section
- Click the file input and select a previously exported
pointless-pos-settings.jsonfile - Click Upload & Import
- Confirm the overwrite prompt
After a successful import, the page will automatically refresh to reflect the restored settings.
REST API Access
The export/import functionality is also available via REST API endpoints for programmatic use:
| Endpoint | Method | Description |
|---|---|---|
/pointless-pos/v1/settings/export | GET | Returns all plugin settings as JSON |
/pointless-pos/v1/settings/import | POST | Accepts a JSON object and updates matching settings |
Both endpoints require manage_options capability and a valid REST nonce.
Security Notes
- All settings are managed only by users with the
manage_optionscapability (administrators) - API URLs should use HTTPS in production
- The Checkout Base URL should point to a trusted domain you control
- Exported JSON files may contain sensitive URLs — treat them like configuration backups