Table of Contents
1. Plugin Overview
TideFort Role Based Pricing is a powerful WooCommerce extension that allows store owners to implement dynamic pricing strategies based on WordPress user roles. The plugin enables you to set different prices for products based on customer roles, create advanced pricing rules with multiple conditions, and control how non-logged-in users interact with your store.
With an intuitive interface integrated directly into the WooCommerce admin, you can easily manage pricing structures that target specific customer segments, enhancing your marketing strategy and customer experience.
2. Key Features
- Role-Based Product Pricing: Set different prices for each WordPress user role
- Advanced Pricing Rules: Create complex pricing rules with multiple conditions
- Flat or Percentage Pricing: Choose between fixed prices or percentage discounts
- Quantity-Based Rules: Set minimum, maximum, and step quantities for purchases
- Individual User Pricing: Apply pricing to specific customers
- Guest User Controls: Customize shopping experience for non-logged-in users
- Custom Messages: Display role-specific messages to users
- Product Category Rules: Apply pricing rules to entire categories
- Rule Prioritization: Control which rules take precedence
- Bulk Rule Management: Enable, disable, or delete multiple rules at once
3. Installation and Requirements
System Requirements:
- WordPress 6.2 or higher
- PHP 7.4 or higher
- WooCommerce 8.2 or higher
Installation:
- Upload the plugin files to /wp-content/plugins/tidefort-role-based-pricing-for-woocommerce or install through the WordPress plugins screen
- Activate the plugin through the 'Plugins' screen in WordPress
- Navigate to WooCommerce > Role-Based Pricing to configure settings
4. Admin Interface
Settings Page
Access the plugin settings through WooCommerce > Settings > Role-Based Pricing.
This page contains several tabs:
Pricing Settings
- Global pricing settings that apply across your store
- Default price display options
- Rule processing priority settings
Non-Logged User Settings
- Control whether guests can view prices
- Set custom "Add to Cart" button text for guests
- Enable/disable purchasing for non-logged users
- Customize error messages for guests attempting to purchase
Role-Based Message Settings
- Create custom messages for specific user roles
- Configure message display locations
- Set message styling options
Managing Roles
Access through WooCommerce > Settings > Manage Roles
- View all WordPress user roles
- Create custom roles for pricing purposes
- Assign capabilities to roles
- Manage role hierarchies
Pricing Rules
Access through WooCommerce > Pricing Rules
The pricing rules system allows you to create complex conditional pricing:
- Rule Creation: Click "Add New Rule" to create a pricing rule
- Rule Components:
- Title: Name for identifying the rule
- Status: Active or Inactive
- Priority: Lower numbers take precedence (1 is highest)
- Products: Include or exclude specific products
- Categories: Apply to specific product categories
- Roles: Include or exclude user roles
- Customers: Include or exclude specific customers
- Pricing Type: Flat or percentage-based
- Quantity Limits: Min/max quantity and step requirements
- Bulk Actions:
- Enable multiple rules
- Disable multiple rules
- Delete multiple rules
Product Settings
For individual product pricing, edit any product and find the "Role-Based Pricing" tab in the product data section:
- Role Selection: Choose a user role to configure
- Pricing Options:
- Flat prices (regular and sale)
- Percentage discount
- Quantity Settings:
- Minimum purchase quantity
- Maximum purchase quantity
- Quantity step increments
5. Pricing Options
Flat Pricing
- Set exact prices for each role
- Independent of the standard product price
- Can include both regular and sale prices
- Example: Administrator sees €50, Shop Manager sees €45
Percentage Discount
- Apply a percentage discount from the standard price
- Automatically updates when base price changes
- Example: 10% discount for "Wholesale" users
Quantity-Based Pricing
Configure purchase quantity rules:
- Minimum Quantity: Required minimum purchase amount
- Maximum Quantity: Upper limit on purchases
- Quantity Step: Forces purchases in specific increments (e.g., must buy in multiples of 5)
6. Guest User Options
Control how non-logged-in visitors interact with your store:
- Hide/Show Prices: Option to hide prices completely from guests
- Purchase Restrictions: Prevent guests from adding products to cart
- Custom Button Text: Change "Add to Cart" text for guests (e.g., "Login to Purchase")
- Custom Error Messages: Display informative messages when guests try to purchase
7. Advanced Features
Role-Based Messages
Display custom messages to specific user roles:
- Welcome messages
- Special offer notifications
- Instructions or guidelines
- Position messages on shop page or product pages
Pricing Rule Conditions
Create sophisticated rules using combinations of:
- Product selections
- Category selections
- User roles
- Specific customers
- Quantity thresholds
Rule Priority System
When multiple rules match a product:
- Role-specific product settings take highest priority
- User-specific product settings take second priority
- Global pricing rules apply based on priority number
- Lower rule numbers take precedence (1 is highest)
8. Troubleshooting & FAQ
Common Issues
Q: Prices aren't changing for roles
A: Check that:
- The user has the exact role specified in settings
- No higher priority rules are overriding your settings
- WooCommerce caching is cleared
Q: Guest restrictions aren't working
A: Ensure the guest restriction options are enabled in WooCommerce > Role-Based Pricing > Non-Logged User Settings.
Q: Can I apply different prices for variations?
A: Yes, you can set role-based pricing for individual variations through the variation settings.
9. Changelog
Version 1.0.0