Accessing Settings
All plugin settings are found under WP-Admin > Slovenská Pošta. Access requires the manage_woocommerce capability (Shop Manager or Administrator role).
Settings Tabs
The settings panel is divided into five tabs:
| Tab | Purpose |
|---|---|
| Pickup Points | Address override, weight & dimension settings, display contexts, order behavior |
| Map Settings | Default map center, zoom levels, animation speed, geolocation, custom icons |
| Pickup Points DB | Manual and automatic pickup point database updates |
| License | License key activation and status |
| Support | Links to documentation and support channels |
All settings are stored in WordPress as a single serialized option under the key wcsp_settings.
Settings Storage Key
All settings are stored in a single WordPress option:
Option name: wcsp_settings
Individual settings are accessed as array keys within this option, for example:
wcsp_settings['replace_shipping_address']wcsp_settings['map_start_zoom']wcsp_settings['pickup_points_db_update_frequency']
When using filters or custom code to read these settings, use get_option('wcsp_settings') and access the relevant key.
Pickup Points
Pickup Points Tab
Navigate to WP-Admin > Slovenská Pošta > Pickup Points to access these settings.
Address Handling
These settings control how the selected pickup point address interacts with the WooCommerce order.
Replace Shipping Address with Pickup Point Address
Key: replace_shipping_address
When enabled, the order’s shipping address is automatically replaced with the pickup point’s address after the order is placed. The pickup point name is stored as the shipping company name on the order.
This is recommended for stores that use the shipping address to print labels or send to a fulfillment system, as it ensures the package is addressed to the pickup point rather than the customer’s home.
Hide Shipping Address Fields at Checkout
Key: hide_shipping_address_fields
Default: Enabled
When enabled, the shipping address form fields are hidden on the checkout page whenever a Slovenská Pošta shipping method is selected. Customers only need to select a pickup point — they do not need to fill in a delivery address.
Disabling this setting shows the standard shipping address form even when a pickup method is chosen.
Display Settings
Controls where pickup point information is shown after an order is placed.
Show in Order Emails
Key: display_in_email
Default: Yes
When enabled, a pickup point summary (name, address, and opening hours) is included in the WooCommerce order confirmation email sent to the customer.
Show on Thank You Page
Key: display_in_thank_you
Default: Yes
When enabled, pickup point details are displayed on the order confirmation (thank you) page immediately after checkout.
Show in My Account — View Order
Key: display_in_view_order
Default: Yes
When enabled, pickup point details are displayed when a logged-in customer views their order under My Account > Orders > View Order.
Weight Settings
These settings affect how cart weight is calculated for pickup point weight limit validation (determining whether a pickup point can accept the parcel). They do not affect shipping cost calculation — for that, see the Packing Material Weight setting on each shipping method instance.
Packaging Weight
Key: packaging_weight
Unit: kg
An additional weight value added to the total cart weight on top of product weights. Use this to account for the weight of packaging materials (boxes, padding, etc.).
Enable Default Weight for Products Without Weight
Key: enable_default_weight
When enabled, products that do not have a weight defined in WooCommerce will use the Default Weight value below. When disabled, products without a weight are treated as weightless (0 kg).
Default Weight
Key: default_weight
Unit: kg
The fallback weight used for products that have no weight set, when Enable Default Weight is active.
Allow Selection Despite Weight Warning
Key: bypass_weight_limit
When enabled, customers can still select a pickup point even if the cart weight exceeds that pickup point’s maximum accepted weight. A warning is shown to the customer but selection is not blocked.
When disabled (default), pickup points that cannot accept the cart weight are visually grayed out and cannot be selected.
Dimension Settings
These settings provide fallback dimensions for products that do not have dimensions set in WooCommerce, used for package validation.
Enable Default Dimensions for Products Without Dimensions
Key: enable_default_dimensions
When enabled, products without dimensions use the defaults below for package size validation.
Default Length / Width / Height
Keys: default_length, default_width, default_height
Unit: cm
Fallback dimensions applied to products that have no dimensions set, when Enable Default Dimensions is active.
BalikoBOX Dimension Settings
These settings define the maximum package dimensions accepted by BalikoBOX lockers.
Maximum BalikoBOX Dimensions
Keys: bbox_max_length, bbox_max_width, bbox_max_height
Defaults: 50 cm × 60 cm × 45 cm
These values define the maximum package size that can fit in a BalikoBOX locker. If the cart contains products whose combined dimensions exceed these values and box packing is enabled, a size warning is shown.
Allow Selection Despite BalikoBOX Size Warning
Key: bypass_size_validation_bbox
When enabled, customers can select a BalikoBOX pickup point even if the package size exceeds the maximum dimensions. A warning is shown but selection is not blocked.
Enable Box Packing Check for BalikoBOX
Key: enable_box_packing_bbox
Default: Yes
When enabled, the plugin runs a bin-packing algorithm to check whether all cart items can physically fit together inside the BalikoBOX dimensions. If they cannot, a warning is shown.
When disabled, only individual product dimensions are checked against the maximum — not whether all items together fit.
Balík na Poštu Dimension Settings
Allow Selection Despite Balík na Poštu Size Warning
Key: bypass_size_validation_bnp
Same behavior as the BalikoBOX equivalent — controls whether customers can proceed past a size warning.
Enable Box Packing Check for Balík na Poštu
Key: enable_box_packing_bnp
Default: Yes
When enabled, the bin-packing check is applied to the configurable Balík na Poštu box dimensions below.
Balík na Poštu Box Dimensions
Keys: bnp_box_length, bnp_box_width, bnp_box_height
Defaults: 100 cm × 50 cm × 50 cm
The shipping box dimensions used for the Balík na Poštu box packing check. These should represent the largest box your store uses for Balík na Poštu shipments.
Note: These are your store’s box dimensions, not Slovenská Pošta’s limits. The hard Slovenská Pošta dimension limits (min face 14×9 cm, max single side 150 cm, max girth 300 cm) are enforced separately and cannot be disabled.
Order Behavior
Auto-Complete Orders
Key: auto_complete_orders
When enabled, WooCommerce orders placed with a Slovenská Pošta shipping method are automatically set to Completed status after payment. This is useful for stores that do not require manual order processing.
Hide Cash on Delivery When Pickup Method Is Selected
Key: hide_cod_for_pickup
When enabled, the WooCommerce Cash on Delivery payment method is hidden from the checkout payment options whenever a Slovenská Pošta shipping method is selected. Use this if you do not offer COD for pickup shipments.
Map Settings
Map Settings Tab
Navigate to WP-Admin > Slovenská Pošta > Map Settings to access these settings.
These settings control the appearance and behavior of the OpenLayers map in the Pickup Point Picker dialog shown to customers at checkout.
Default Map View
Starting Zoom Level
Key: map_start_zoom
Default: 7
Range: 1 (world view) — 19 (street level)
The zoom level when the pickup point picker dialog first opens, before any search or geolocation is performed. The default value of 7 shows most of Slovakia in the map viewport.
Starting Latitude
Key: map_start_lat
Default: 48.6690
The latitude coordinate for the map center on initial load.
Starting Longitude
Key: map_start_lng
Default: 19.6990
The longitude coordinate for the map center on initial load.
Tip: The default coordinates (48.669°N, 19.699°E) represent the approximate geographic center of Slovakia. If your customer base is concentrated in a specific region, adjust these to center the map there.
Selection Behavior
Zoom Level on Pickup Point Selection
Key: map_selection_zoom
Default: 14
When a customer selects a pickup point from the results list, the map animates to center on that point. This setting controls how far the map zooms in. Level 14 shows street-level detail.
Animation Speed
Key: map_animation_speed
Default: 500
Unit: milliseconds
The duration of the pan and zoom animation when the map moves to a selected pickup point. Set to 0 to disable animation entirely.
Geolocation
Auto-Request Geolocation on Dialog Open
Key: auto_geolocation
Default: Yes
When enabled, the pickup point picker dialog automatically requests the customer’s browser location (via the Geolocation API) as soon as the dialog opens. If the customer grants permission, the map centers on their location and nearby pickup points are listed in the results.
When disabled, customers must manually click the "My Location" button to use geolocation.
Browser behavior: The browser will prompt the customer for location permission the first time. If the customer previously denied permission, the auto-request will silently fail and the map will show the default center position.
Custom Map Icons
You can replace the default map pin icons with custom images. Each icon type has three settings: the image URL, and the anchor point (x and y, expressed as decimals from 0 to 1) that defines which part of the image is placed on the map coordinate.
An anchor of 0.5, 1.0 places the bottom center of the image on the map point — appropriate for a standard map pin shape.
Cluster Icon
Keys: map_icon_cluster, map_icon_cluster_anchor_x, map_icon_cluster_anchor_y
The icon displayed when multiple pickup points are grouped into a cluster (shown when the map is zoomed out).
Regular Pickup Point Icon
Keys: map_icon_regular, map_icon_regular_anchor_x, map_icon_regular_anchor_y
The default map pin shown for individual, unselected pickup points.
Selected Pickup Point Icon
Keys: map_icon_selected, map_icon_selected_anchor_x, map_icon_selected_anchor_y
The map pin shown for the currently selected pickup point.
Image format: PNG or SVG images work best. Images should be hosted on your own domain or a reliable CDN. The anchor coordinates are decimal values between 0 and 1 (e.g.,
0.5= 50% from the left/top edge).
Pickup Points Database
Pickup Points DB Tab
Navigate to WP-Admin > Slovenská Pošta > Pickup Points DB to access these settings.
This tab provides tools to populate and refresh the local database of Slovenská Pošta pickup points. The plugin stores all pickup point data locally — no live API calls are made during checkout. This tab is where you keep that data current.
Database Status
The top of the tab displays current statistics:
- Balík na Poštu pickup points: Total count of BNP locations in the database.
- BalikoBOX locations: Total count of BalikoBOX locker locations.
- Last updated: The timestamp of the most recent successful database update.
Manual Update
Click Update Now to immediately fetch and import the latest pickup point data from the Slovenská Pošta XML feed.
The update process:
- Downloads the XML file from the configured URL (default:
https://www.posta.sk/public/forms/zoznam_post.xml). - Parses the XML and validates the entries.
- Safety check: If fewer than 100 valid entries are found, the update is aborted to prevent accidentally replacing the database with incomplete data.
- Truncates and replaces the existing pickup point data.
- Updates the "last updated" timestamp.
The process runs via AJAX in the background — the page displays a progress indicator and shows a success or error message on completion.
Automatic Updates
Enable Automatic Updates
Key: auto_update_enabled
When enabled, the plugin uses WP-Cron to automatically update the pickup point database on a schedule, without requiring manual intervention.
Update Frequency
Key: auto_update_frequency
Default: weekly
How often the automatic update runs. Available options:
| Value | Frequency |
|---|---|
daily |
Once per day |
twicedaily |
Twice per day |
weekly |
Once per week (recommended) |
twicemonthly |
Twice per month |
monthly |
Once per month |
Recommendation: Weekly updates are sufficient for most stores. Slovenská Pošta does not change pickup point data frequently, and daily updates are generally unnecessary.
WP-Cron dependency: Automatic updates rely on WP-Cron, which is triggered by site traffic. On low-traffic sites, scheduled events may not fire at their exact scheduled time. For guaranteed scheduling on low-traffic sites, consider using a real cron job to trigger
wp-cron.php.
Customizing the XML Feed URL
By default, pickup point data is fetched from:
https://www.posta.sk/public/forms/zoznam_post.xml
To use a different URL (e.g., a local mirror or a custom feed), define the following constant in your wp-config.php:
define( 'WCSP_PICKUP_POINTS_XML_URL', 'https://your-custom-url.com/feed.xml' );
License
License Tab
Navigate to WP-Admin > Slovenská Pošta > License to manage your plugin license.
For full details on how licensing works, including the grace period and validation behavior, see License Activation.
License Key Field
Enter your license key in this field and click Activate License to activate the plugin on your domain.
License Status
This section shows the current license state:
- Status: Active, Inactive, Expired, Revoked, or Grace Period.
- Domain: The domain the license is currently activated on.
- Expiration: The license expiration date (if applicable).
- Last Validated: The timestamp of the most recent license check.
Activating and Deactivating
- Activate: Enter the license key and click Activate License. The plugin contacts the license server at
webdevelop.huto validate the key. - Deactivate: Click Deactivate License to release the license from this domain. Do this before migrating your site to a new domain.
See License Activation for a complete walkthrough and explanation of validation behavior.