first commit

README.md

@@ -0,0 +1,160 @@
+# WHMCS Pricing
+
+Display WHMCS product prices on WordPress using shortcodes. Lightweight, cached, works with Elementor.
+
+## Installation
+
+1. Upload ZIP via `Plugins > Add New > Upload Plugin`
+2. Activate
+3. Go to `Settings > WHMCS Pricing`
+4. Enter your WHMCS credentials
+
+## WHMCS Setup
+
+**Step 1: Allow API Access by IP**
+
+1. Go to `General Settings > Security` tab in WHMCS
+2. Find **API IP Access Restriction**
+3. Add your WordPress server IP address
+4. Save changes
+
+**Step 2: Generate API Credentials**
+
+1. Go to `System Settings > API Credentials`
+2. Click `Generate New API Credential`
+3. Set Access Type to `Allowed`
+4. Copy Identifier and Secret
+
+Enter these in WordPress plugin settings along with your WHMCS URL.
+
+**Security Note:** Without adding your WordPress server IP to API IP Access Restriction, the API calls will be blocked by WHMCS.
+
+## Usage
+
+Basic shortcode:
+```
+[whmcs_price product_id="123" billing_cycle="annually"]
+```
+
+### Parameters
+
+- `product_id` - WHMCS product ID (required)
+- `billing_cycle` - monthly, quarterly, semiannually, annually, biennially, triennially (default: monthly)
+- `currency` - EUR, USD, GBP, etc. (uses plugin default if not specified)
+- `format` - `default` or `no_decimals`
+- `show_cycle` - `true` or `false` (default: true)
+- `lang` - Language: `english`, `spanish`, `portuguese-pt`, `dutch`, `french`, `german`, `russian` (default: english)
+- `class` - Custom CSS class
+
+### Examples
+
+```
+[whmcs_price product_id="5" billing_cycle="annually"]
+Output: €24.00 per year
+
+[whmcs_price product_id="5" billing_cycle="monthly" format="no_decimals"]
+Output: €3 per month
+
+[whmcs_price product_id="5" currency="USD" show_cycle="false"]
+Output: $3.50
+
+[whmcs_price product_id="5" billing_cycle="annually" lang="spanish"]
+Output: €24.00 por año
+
+[whmcs_price product_id="5" billing_cycle="monthly" lang="dutch"]
+Output: €3.00 per maand
+```
+
+### Translations
+
+Billing cycle text is translated via `languages.json`. Supported languages:
+- `english`
+- `spanish`
+- `portuguese-pt`
+- `dutch`
+- `french`
+- `german`
+- `russian`
+
+Add more languages by editing `languages.json` in the plugin folder (uses WHMCS language naming).
+
+```json
+{
+  "italian": {
+    "monthly": "al mese",
+    "annually": "all'anno"
+  }
+}
+```
+
+### Find Product IDs
+
+In WHMCS admin:
+1. `System Settings > Products/Services`
+2. Click a product
+3. ID is in URL: `?id=123`
+
+## HTML Output
+
+```html
+<span class="whmcs-price" data-product-id="123" data-cycle="annually">
+  <span class="currency-symbol">€</span>
+  <span class="price-amount">24.00</span>
+  <span class="billing-cycle">per year</span>
+</span>
+```
+
+Style it with CSS:
+
+```css
+.whmcs-price { font-weight: bold; }
+.price-amount { font-size: 24px; }
+```
+
+## Important Notes
+
+**WHMCS uses `-1.00` for unavailable billing cycles.** If a product doesn't have monthly pricing in WHMCS, don't use `billing_cycle="monthly"` in the shortcode. Check your WHMCS product configuration first.
+
+**Caching:** Prices are cached for 1 hour by default. Change this in plugin settings. Click "Clear All Cache" after updating prices in WHMCS.
+
+**Errors:** Only administrators see error messages. Regular visitors see nothing if a price can't be loaded.
+
+## Settings
+
+- **WHMCS URL** - Your WHMCS installation URL (https://billing.yourdomain.com)
+- **API Identifier** - From WHMCS API credentials
+- **API Secret** - From WHMCS API credentials
+- **Default Currency** - Fallback currency (EUR, USD, etc.)
+- **Show Decimals** - Toggle decimal places globally
+- **Cache Duration** - How long to cache API responses (seconds)
+- **Debug Mode** - Enable logging, disable cache
+
+## Troubleshooting
+
+**Price shows as -1.00:**
+- That billing cycle isn't available for this product in WHMCS
+- Use a different `billing_cycle` parameter
+
+**No price displays:**
+- Check product ID exists in WHMCS
+- Verify API credentials are correct
+- Enable Debug Mode and check `/wp-content/debug.log`
+- Clear plugin cache
+
+**Wrong price:**
+- Clear cache (prices are cached)
+- Check currency matches WHMCS configuration
+- Verify billing cycle is available
+
+## Requirements
+
+- WordPress 5.0+
+- PHP 7.4+
+- WHMCS 8.x with API access
+- SSL recommended
+
+## Support
+
+**By:** ArkHost
+**Sponsored by:** Duplika.com
+**License:** GPL v2+

whmcs-pricing-plugin/.gitignore

@@ -0,0 +1,68 @@
+# WordPress
+.htaccess
+wp-config.php
+wp-content/uploads/
+wp-content/blogs.dir/
+wp-content/upgrade/
+wp-content/backup-db/
+wp-content/advanced-cache.php
+wp-content/wp-cache-config.php
+wp-content/cache/
+wp-content/cache/supercache/
+
+# Plugin Development
+node_modules/
+vendor/
+composer.lock
+package-lock.json
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# IDE
+.idea/
+.vscode/
+*.sublime-project
+*.sublime-workspace
+.DS_Store
+Thumbs.db
+
+# Testing
+tests/
+phpunit.xml
+.phpunit.result.cache
+
+# Build
+dist/
+build/
+*.zip
+!whmcs-pricing-plugin.zip
+
+# Environment
+.env
+.env.local
+.env.*.local
+
+# OS
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+*~
+
+# Temporary
+*.tmp
+*.temp
+*.bak
+*.swp
+*.swo
+*~
+
+# Logs
+*.log
+error_log
+debug.log

whmcs-pricing-plugin/assets/css/admin.css

@@ -0,0 +1,147 @@
+/**
+ * WHMCS Pricing Admin Styles
+ */
+
+.whmcs-pricing-admin {
+    max-width: 1200px;
+}
+
+.whmcs-pricing-container {
+    display: flex;
+    gap: 30px;
+    margin-top: 20px;
+}
+
+.whmcs-pricing-main {
+    flex: 1;
+    min-width: 0;
+}
+
+.whmcs-pricing-sidebar {
+    width: 350px;
+    flex-shrink: 0;
+}
+
+.whmcs-pricing-box {
+    background: #fff;
+    border: 1px solid #ccd0d4;
+    border-radius: 4px;
+    padding: 20px;
+    margin-bottom: 20px;
+    box-shadow: 0 1px 1px rgba(0, 0, 0, 0.04);
+}
+
+.whmcs-pricing-box h3 {
+    margin-top: 0;
+    margin-bottom: 15px;
+    font-size: 16px;
+    font-weight: 600;
+    border-bottom: 1px solid #eee;
+    padding-bottom: 10px;
+}
+
+.whmcs-pricing-box h4 {
+    margin-top: 20px;
+    margin-bottom: 8px;
+    font-size: 13px;
+    font-weight: 600;
+    color: #555;
+}
+
+.whmcs-pricing-box h4:first-of-type {
+    margin-top: 15px;
+}
+
+.whmcs-pricing-box code {
+    display: block;
+    background: #f6f7f7;
+    border: 1px solid #ddd;
+    border-radius: 3px;
+    padding: 10px;
+    margin: 8px 0 15px 0;
+    font-size: 12px;
+    font-family: 'Courier New', monospace;
+    word-wrap: break-word;
+    color: #c92c2c;
+}
+
+.whmcs-pricing-box ul {
+    margin: 10px 0;
+    padding-left: 20px;
+}
+
+.whmcs-pricing-box ul li {
+    margin: 5px 0;
+    font-size: 13px;
+    color: #555;
+}
+
+.whmcs-pricing-box p {
+    margin: 10px 0;
+    line-height: 1.6;
+}
+
+.whmcs-pricing-box p strong {
+    color: #1d2327;
+}
+
+/* Form styles */
+.whmcs-pricing-admin .form-table th {
+    width: 200px;
+}
+
+.whmcs-pricing-admin input[type="text"],
+.whmcs-pricing-admin input[type="password"],
+.whmcs-pricing-admin input[type="number"],
+.whmcs-pricing-admin select {
+    width: 100%;
+    max-width: 500px;
+}
+
+.whmcs-pricing-admin .description {
+    color: #646970;
+    font-size: 13px;
+    margin-top: 8px;
+}
+
+/* Settings sections */
+.whmcs-pricing-admin h2 {
+    margin-top: 30px;
+    padding-bottom: 10px;
+    border-bottom: 2px solid #2271b1;
+    color: #1d2327;
+}
+
+/* Buttons */
+.whmcs-pricing-admin .submit {
+    padding-top: 0;
+    margin-bottom: 20px;
+}
+
+/* Responsive */
+@media screen and (max-width: 960px) {
+    .whmcs-pricing-container {
+        flex-direction: column;
+    }
+
+    .whmcs-pricing-sidebar {
+        width: 100%;
+    }
+
+    .whmcs-pricing-admin input[type="text"],
+    .whmcs-pricing-admin input[type="password"],
+    .whmcs-pricing-admin input[type="number"],
+    .whmcs-pricing-admin select {
+        max-width: 100%;
+    }
+}
+
+/* Success/Error messages */
+.whmcs-pricing-admin .notice {
+    margin: 20px 0;
+}
+
+/* Help text */
+.whmcs-pricing-admin .form-table td p:first-child {
+    margin-top: 0;
+}

whmcs-pricing-plugin/includes/admin-settings.php

@@ -0,0 +1,551 @@
+<?php
+/**
+ * Admin Settings
+ *
+ * Handles plugin settings page in WordPress admin
+ */
+
+// Exit if accessed directly
+if (!defined('ABSPATH')) {
+    exit;
+}
+
+class WHMCS_Pricing_Admin {
+
+    /**
+     * Single instance
+     */
+    private static $instance = null;
+
+    /**
+     * Get instance
+     */
+    public static function get_instance() {
+        if (null === self::$instance) {
+            self::$instance = new self();
+        }
+        return self::$instance;
+    }
+
+    /**
+     * Constructor
+     */
+    private function __construct() {
+        add_action('admin_menu', array($this, 'add_admin_menu'));
+        add_action('admin_init', array($this, 'register_settings'));
+        add_action('admin_enqueue_scripts', array($this, 'enqueue_admin_styles'));
+        add_action('admin_post_whmcs_clear_cache', array($this, 'handle_clear_cache'));
+    }
+
+    /**
+     * Add admin menu
+     */
+    public function add_admin_menu() {
+        add_options_page(
+            __('WHMCS Pricing Settings', 'whmcs-pricing'),
+            __('WHMCS Pricing', 'whmcs-pricing'),
+            'manage_options',
+            'whmcs-pricing',
+            array($this, 'render_settings_page')
+        );
+    }
+
+    /**
+     * Register settings
+     */
+    public function register_settings() {
+        register_setting(
+            'whmcs_pricing_settings',
+            'whmcs_pricing_settings',
+            array($this, 'sanitize_settings')
+        );
+
+        // API Settings Section
+        add_settings_section(
+            'whmcs_pricing_api_section',
+            __('WHMCS API Configuration', 'whmcs-pricing'),
+            array($this, 'render_api_section'),
+            'whmcs-pricing'
+        );
+
+        add_settings_field(
+            'api_url',
+            __('WHMCS URL', 'whmcs-pricing'),
+            array($this, 'render_text_field'),
+            'whmcs-pricing',
+            'whmcs_pricing_api_section',
+            array(
+                'name' => 'api_url',
+                'placeholder' => 'https://your-whmcs-domain.com',
+                'description' => __('Your WHMCS installation URL (without /includes/api.php)', 'whmcs-pricing')
+            )
+        );
+
+        add_settings_field(
+            'api_identifier',
+            __('API Identifier', 'whmcs-pricing'),
+            array($this, 'render_text_field'),
+            'whmcs-pricing',
+            'whmcs_pricing_api_section',
+            array(
+                'name' => 'api_identifier',
+                'description' => __('Your WHMCS API identifier', 'whmcs-pricing')
+            )
+        );
+
+        add_settings_field(
+            'api_secret',
+            __('API Secret', 'whmcs-pricing'),
+            array($this, 'render_password_field'),
+            'whmcs-pricing',
+            'whmcs_pricing_api_section',
+            array(
+                'name' => 'api_secret',
+                'description' => __('Your WHMCS API secret', 'whmcs-pricing')
+            )
+        );
+
+        // Display Settings Section
+        add_settings_section(
+            'whmcs_pricing_display_section',
+            __('Display Settings', 'whmcs-pricing'),
+            array($this, 'render_display_section'),
+            'whmcs-pricing'
+        );
+
+        add_settings_field(
+            'default_currency',
+            __('Default Currency', 'whmcs-pricing'),
+            array($this, 'render_currency_field'),
+            'whmcs-pricing',
+            'whmcs_pricing_display_section',
+            array(
+                'name' => 'default_currency',
+                'description' => __('Default currency for pricing display', 'whmcs-pricing')
+            )
+        );
+
+        add_settings_field(
+            'show_decimals',
+            __('Show Decimals', 'whmcs-pricing'),
+            array($this, 'render_checkbox_field'),
+            'whmcs-pricing',
+            'whmcs_pricing_display_section',
+            array(
+                'name' => 'show_decimals',
+                'label' => __('Display prices with decimal places (e.g., €67.00 instead of €67)', 'whmcs-pricing')
+            )
+        );
+
+        // Performance Settings Section
+        add_settings_section(
+            'whmcs_pricing_performance_section',
+            __('Performance Settings', 'whmcs-pricing'),
+            array($this, 'render_performance_section'),
+            'whmcs-pricing'
+        );
+
+        add_settings_field(
+            'cache_duration',
+            __('Cache Duration', 'whmcs-pricing'),
+            array($this, 'render_number_field'),
+            'whmcs-pricing',
+            'whmcs_pricing_performance_section',
+            array(
+                'name' => 'cache_duration',
+                'min' => 300,
+                'max' => 86400,
+                'step' => 300,
+                'description' => __('How long to cache API responses (in seconds). Default: 3600 (1 hour)', 'whmcs-pricing')
+            )
+        );
+
+        // Advanced Settings Section
+        add_settings_section(
+            'whmcs_pricing_advanced_section',
+            __('Advanced Settings', 'whmcs-pricing'),
+            array($this, 'render_advanced_section'),
+            'whmcs-pricing'
+        );
+
+        add_settings_field(
+            'debug_mode',
+            __('Debug Mode', 'whmcs-pricing'),
+            array($this, 'render_checkbox_field'),
+            'whmcs-pricing',
+            'whmcs_pricing_advanced_section',
+            array(
+                'name' => 'debug_mode',
+                'label' => __('Enable debug logging and disable cache', 'whmcs-pricing')
+            )
+        );
+    }
+
+    /**
+     * Render settings page
+     */
+    public function render_settings_page() {
+        if (!current_user_can('manage_options')) {
+            return;
+        }
+
+        // Show success message
+        if (isset($_GET['settings-updated'])) {
+            add_settings_error(
+                'whmcs_pricing_messages',
+                'whmcs_pricing_message',
+                __('Settings saved successfully.', 'whmcs-pricing'),
+                'updated'
+            );
+        }
+
+        if (isset($_GET['cache-cleared'])) {
+            add_settings_error(
+                'whmcs_pricing_messages',
+                'whmcs_pricing_message',
+                __('Cache cleared successfully.', 'whmcs-pricing'),
+                'updated'
+            );
+        }
+
+        settings_errors('whmcs_pricing_messages');
+        ?>
+        <div class="wrap whmcs-pricing-admin">
+            <h1><?php echo esc_html(get_admin_page_title()); ?></h1>
+
+            <div class="whmcs-pricing-container">
+                <div class="whmcs-pricing-main">
+                    <form action="options.php" method="post">
+                        <?php
+                        settings_fields('whmcs_pricing_settings');
+                        do_settings_sections('whmcs-pricing');
+                        submit_button(__('Save Settings', 'whmcs-pricing'));
+                        ?>
+                    </form>
+
+                    <form method="post" action="<?php echo esc_url(admin_url('admin-post.php')); ?>">
+                        <?php wp_nonce_field('whmcs_clear_cache', 'whmcs_cache_nonce'); ?>
+                        <input type="hidden" name="action" value="whmcs_clear_cache">
+                        <?php submit_button(__('Clear All Cache', 'whmcs-pricing'), 'secondary', 'clear_cache', false); ?>
+                    </form>
+                </div>
+
+                <div class="whmcs-pricing-sidebar">
+                    <div class="whmcs-pricing-box">
+                        <h3 class="whmcs-toggle" style="cursor: pointer;">
+                            <?php _e('Shortcode Usage', 'whmcs-pricing'); ?> <span style="float: right;">▲</span>
+                        </h3>
+                        <p class="whmcs-preview" style="margin: 10px 0; color: #666; font-size: 13px; display: none;">
+                            <?php _e('Expand to view shortcode examples and parameters...', 'whmcs-pricing'); ?>
+                        </p>
+                        <div class="whmcs-toggle-content">
+                            <p><?php _e('Use these shortcodes in your posts, pages, or Elementor:', 'whmcs-pricing'); ?></p>
+
+                            <h4><?php _e('Basic Usage:', 'whmcs-pricing'); ?></h4>
+                            <code>[whmcs_price product_id="123"]</code>
+
+                            <h4><?php _e('With Billing Cycle:', 'whmcs-pricing'); ?></h4>
+                            <code>[whmcs_price product_id="123" billing_cycle="monthly"]</code>
+
+                            <h4><?php _e('With Currency:', 'whmcs-pricing'); ?></h4>
+                            <code>[whmcs_price product_id="123" currency="EUR"]</code>
+
+                            <h4><?php _e('Without Decimals:', 'whmcs-pricing'); ?></h4>
+                            <code>[whmcs_price product_id="123" format="no_decimals"]</code>
+
+                            <h4><?php _e('With Language:', 'whmcs-pricing'); ?></h4>
+                            <code>[whmcs_price product_id="123" lang="dutch"]</code>
+
+                            <h4><?php _e('Available Billing Cycles:', 'whmcs-pricing'); ?></h4>
+                            <ul>
+                                <li>monthly</li>
+                                <li>quarterly</li>
+                                <li>semiannually</li>
+                                <li>annually</li>
+                                <li>biennially</li>
+                                <li>triennially</li>
+                            </ul>
+                        </div>
+                    </div>
+
+                    <div class="whmcs-pricing-box">
+                        <h3 class="whmcs-toggle" style="cursor: pointer;">
+                            <?php _e('CSS Styling Guide', 'whmcs-pricing'); ?> <span style="float: right;">▼</span>
+                        </h3>
+                        <p class="whmcs-preview" style="margin: 10px 0; color: #666; font-size: 13px;">
+                            <?php _e('Expand to view CSS examples and styling options...', 'whmcs-pricing'); ?>
+                        </p>
+                        <div class="whmcs-toggle-content" style="display: none;">
+                            <p><?php _e('Add custom CSS to style your prices. Go to Appearance > Customize > Additional CSS:', 'whmcs-pricing'); ?></p>
+
+                            <h4><?php _e('HTML Structure:', 'whmcs-pricing'); ?></h4>
+                            <code style="white-space: pre-wrap;">&lt;span class="whmcs-price"&gt;
+  &lt;span class="currency-symbol"&gt;€&lt;/span&gt;
+  &lt;span class="price-amount"&gt;67.00&lt;/span&gt;
+  &lt;span class="billing-cycle"&gt;per month&lt;/span&gt;
+&lt;/span&gt;</code>
+
+                            <h4><?php _e('Example CSS:', 'whmcs-pricing'); ?></h4>
+                            <code style="white-space: pre-wrap;">.whmcs-price {
+  font-size: 24px;
+  font-weight: bold;
+  color: #2271b1;
+}
+
+.whmcs-price .price-amount {
+  font-size: 32px;
+}
+
+.whmcs-price .billing-cycle {
+  font-size: 14px;
+  color: #666;
+}</code>
+
+                            <h4><?php _e('Using Custom Class:', 'whmcs-pricing'); ?></h4>
+                            <code>[whmcs_price product_id="123" class="featured"]</code>
+                            <p style="margin-top: 8px; font-size: 13px;"><?php _e('Then style with: .whmcs-price.featured { }', 'whmcs-pricing'); ?></p>
+                        </div>
+                    </div>
+
+                    <div class="whmcs-pricing-box">
+                        <h3><?php _e('Plugin Information', 'whmcs-pricing'); ?></h3>
+                        <p><strong><?php _e('Version:', 'whmcs-pricing'); ?></strong> <?php echo WHMCS_PRICING_VERSION; ?></p>
+                        <p><strong><?php _e('Author:', 'whmcs-pricing'); ?></strong> <a href="https://arkhost.com" target="_blank" rel="noopener noreferrer">ArkHost</a></p>
+                        <p><strong><?php _e('Sponsored by:', 'whmcs-pricing'); ?></strong> <a href="https://duplika.com" target="_blank" rel="noopener noreferrer">Duplika</a></p>
+                    </div>
+                </div>
+            </div>
+        </div>
+
+        <script>
+        jQuery(document).ready(function($) {
+            $('.whmcs-toggle').on('click', function() {
+                var clickedBox = $(this).parent();
+                var clickedPreview = clickedBox.find('.whmcs-preview');
+                var clickedContent = clickedBox.find('.whmcs-toggle-content');
+                var clickedArrow = $(this).find('span');
+
+                // Close all other boxes first
+                $('.whmcs-pricing-box').not(clickedBox).each(function() {
+                    var otherPreview = $(this).find('.whmcs-preview');
+                    var otherContent = $(this).find('.whmcs-toggle-content');
+                    var otherArrow = $(this).find('.whmcs-toggle span');
+
+                    if (otherContent.is(':visible')) {
+                        otherPreview.slideDown(200);
+                        otherContent.slideUp(200);
+                        otherArrow.html('▼');
+                    }
+                });
+
+                // Toggle clicked box
+                clickedPreview.slideToggle(200);
+                clickedContent.slideToggle(200);
+
+                if (clickedContent.is(':visible')) {
+                    clickedArrow.html('▲');
+                } else {
+                    clickedArrow.html('▼');
+                }
+            });
+        });
+        </script>
+        <?php
+    }
+
+    /**
+     * Section callbacks
+     */
+    public function render_api_section() {
+        echo '<p>' . esc_html__('Configure your WHMCS API credentials. You can generate API credentials in WHMCS Admin > System Settings > API Credentials.', 'whmcs-pricing') . '</p>';
+    }
+
+    public function render_display_section() {
+        echo '<p>' . esc_html__('Configure how prices are displayed on your website.', 'whmcs-pricing') . '</p>';
+    }
+
+    public function render_performance_section() {
+        echo '<p>' . esc_html__('Optimize plugin performance with caching.', 'whmcs-pricing') . '</p>';
+    }
+
+    public function render_advanced_section() {
+        echo '<p>' . esc_html__('Advanced options for troubleshooting and development.', 'whmcs-pricing') . '</p>';
+    }
+
+    /**
+     * Field rendering methods
+     */
+    public function render_text_field($args) {
+        $settings = get_option('whmcs_pricing_settings', array());
+        $value = isset($settings[$args['name']]) ? $settings[$args['name']] : '';
+        $placeholder = isset($args['placeholder']) ? $args['placeholder'] : '';
+        ?>
+        <input type="text"
+               name="whmcs_pricing_settings[<?php echo esc_attr($args['name']); ?>]"
+               value="<?php echo esc_attr($value); ?>"
+               placeholder="<?php echo esc_attr($placeholder); ?>"
+               class="regular-text">
+        <?php if (isset($args['description'])): ?>
+            <p class="description"><?php echo esc_html($args['description']); ?></p>
+        <?php endif; ?>
+        <?php
+    }
+
+    public function render_password_field($args) {
+        $settings = get_option('whmcs_pricing_settings', array());
+        $value = isset($settings[$args['name']]) ? $settings[$args['name']] : '';
+        ?>
+        <input type="password"
+               name="whmcs_pricing_settings[<?php echo esc_attr($args['name']); ?>]"
+               value="<?php echo esc_attr($value); ?>"
+               class="regular-text">
+        <?php if (isset($args['description'])): ?>
+            <p class="description"><?php echo esc_html($args['description']); ?></p>
+        <?php endif; ?>
+        <?php
+    }
+
+    public function render_number_field($args) {
+        $settings = get_option('whmcs_pricing_settings', array());
+        $value = isset($settings[$args['name']]) ? $settings[$args['name']] : '';
+        $min = isset($args['min']) ? $args['min'] : 0;
+        $max = isset($args['max']) ? $args['max'] : 100000;
+        $step = isset($args['step']) ? $args['step'] : 1;
+        ?>
+        <input type="number"
+               name="whmcs_pricing_settings[<?php echo esc_attr($args['name']); ?>]"
+               value="<?php echo esc_attr($value); ?>"
+               min="<?php echo esc_attr($min); ?>"
+               max="<?php echo esc_attr($max); ?>"
+               step="<?php echo esc_attr($step); ?>"
+               class="regular-text">
+        <?php if (isset($args['description'])): ?>
+            <p class="description"><?php echo esc_html($args['description']); ?></p>
+        <?php endif; ?>
+        <?php
+    }
+
+    public function render_checkbox_field($args) {
+        $settings = get_option('whmcs_pricing_settings', array());
+        $checked = isset($settings[$args['name']]) && $settings[$args['name']] ? 'checked' : '';
+        ?>
+        <label>
+            <input type="checkbox"
+                   name="whmcs_pricing_settings[<?php echo esc_attr($args['name']); ?>]"
+                   value="1"
+                   <?php echo $checked; ?>>
+            <?php echo esc_html($args['label']); ?>
+        </label>
+        <?php
+    }
+
+    public function render_currency_field($args) {
+        $settings = get_option('whmcs_pricing_settings', array());
+        $value = isset($settings[$args['name']]) ? $settings[$args['name']] : 'USD';
+
+        $currencies = array(
+            'USD' => 'USD - US Dollar ($)',
+            'EUR' => 'EUR - Euro (€)',
+            'GBP' => 'GBP - British Pound (£)',
+            'AUD' => 'AUD - Australian Dollar (A$)',
+            'CAD' => 'CAD - Canadian Dollar (C$)',
+            'JPY' => 'JPY - Japanese Yen (¥)',
+            'CNY' => 'CNY - Chinese Yuan (¥)',
+            'INR' => 'INR - Indian Rupee (₹)',
+            'BRL' => 'BRL - Brazilian Real (R$)',
+            'RUB' => 'RUB - Russian Ruble (₽)',
+            'CHF' => 'CHF - Swiss Franc (Fr)',
+            'SEK' => 'SEK - Swedish Krona (kr)',
+            'NOK' => 'NOK - Norwegian Krone (kr)',
+            'DKK' => 'DKK - Danish Krone (kr)',
+            'PLN' => 'PLN - Polish Zloty (zł)',
+            'THB' => 'THB - Thai Baht (฿)',
+            'MYR' => 'MYR - Malaysian Ringgit (RM)',
+            'SGD' => 'SGD - Singapore Dollar (S$)',
+            'NZD' => 'NZD - New Zealand Dollar (NZ$)',
+            'MXN' => 'MXN - Mexican Peso (Mex$)',
+            'ZAR' => 'ZAR - South African Rand (R)'
+        );
+        ?>
+        <select name="whmcs_pricing_settings[<?php echo esc_attr($args['name']); ?>]" class="regular-text">
+            <?php foreach ($currencies as $code => $label): ?>
+                <option value="<?php echo esc_attr($code); ?>" <?php selected($value, $code); ?>>
+                    <?php echo esc_html($label); ?>
+                </option>
+            <?php endforeach; ?>
+        </select>
+        <?php if (isset($args['description'])): ?>
+            <p class="description"><?php echo esc_html($args['description']); ?></p>
+        <?php endif; ?>
+        <?php
+    }
+
+    /**
+     * Sanitize settings
+     */
+    public function sanitize_settings($input) {
+        $sanitized = array();
+
+        // Sanitize URL
+        if (isset($input['api_url'])) {
+            $sanitized['api_url'] = esc_url_raw($input['api_url']);
+        }
+
+        // Sanitize text fields
+        $text_fields = array('api_identifier', 'api_secret', 'default_currency');
+        foreach ($text_fields as $field) {
+            if (isset($input[$field])) {
+                $sanitized[$field] = sanitize_text_field($input[$field]);
+            }
+        }
+
+        // Sanitize number
+        if (isset($input['cache_duration'])) {
+            $sanitized['cache_duration'] = absint($input['cache_duration']);
+        }
+
+        // Sanitize checkboxes
+        $sanitized['show_decimals'] = isset($input['show_decimals']) ? true : false;
+        $sanitized['debug_mode'] = isset($input['debug_mode']) ? true : false;
+
+        return $sanitized;
+    }
+
+    /**
+     * Handle clear cache action
+     */
+    public function handle_clear_cache() {
+        if (!current_user_can('manage_options')) {
+            wp_die(__('Unauthorized', 'whmcs-pricing'));
+        }
+
+        check_admin_referer('whmcs_clear_cache', 'whmcs_cache_nonce');
+
+        WHMCS_Pricing_API::clear_all_cache();
+
+        wp_redirect(add_query_arg(
+            array(
+                'page' => 'whmcs-pricing',
+                'cache-cleared' => 'true'
+            ),
+            admin_url('options-general.php')
+        ));
+        exit;
+    }
+
+    /**
+     * Enqueue admin styles
+     */
+    public function enqueue_admin_styles($hook) {
+        if ('settings_page_whmcs-pricing' !== $hook) {
+            return;
+        }
+
+        wp_enqueue_style(
+            'whmcs-pricing-admin',
+            WHMCS_PRICING_PLUGIN_URL . 'assets/css/admin.css',
+            array(),
+            WHMCS_PRICING_VERSION
+        );
+    }
+}

whmcs-pricing-plugin/includes/api-handler.php

@@ -0,0 +1,316 @@
+<?php
+/**
+ * WHMCS API Handler
+ *
+ * Handles all communication with WHMCS API
+ */
+
+// Exit if accessed directly
+if (!defined('ABSPATH')) {
+    exit;
+}
+
+class WHMCS_Pricing_API {
+
+    /**
+     * Get settings
+     */
+    private static function get_settings() {
+        $defaults = array(
+            'api_url' => '',
+            'api_identifier' => '',
+            'api_secret' => '',
+            'cache_duration' => 3600,
+            'default_currency' => 'USD',
+            'show_decimals' => true,
+            'debug_mode' => false
+        );
+
+        $settings = get_option('whmcs_pricing_settings', $defaults);
+        return wp_parse_args($settings, $defaults);
+    }
+
+    /**
+     * Make API request to WHMCS
+     */
+    private static function make_request($action, $params = array()) {
+        $settings = self::get_settings();
+
+        // Validate settings
+        if (empty($settings['api_url']) || empty($settings['api_identifier']) || empty($settings['api_secret'])) {
+            self::log_error('API credentials not configured');
+            return new WP_Error('missing_credentials', __('WHMCS API credentials not configured', 'whmcs-pricing'));
+        }
+
+        // Prepare API request
+        $api_url = rtrim($settings['api_url'], '/') . '/includes/api.php';
+
+        $post_data = array_merge(array(
+            'action' => $action,
+            'identifier' => $settings['api_identifier'],
+            'secret' => $settings['api_secret'],
+            'responsetype' => 'json'
+        ), $params);
+
+        // Make request
+        $response = wp_remote_post($api_url, array(
+            'timeout' => 15,
+            'body' => $post_data,
+            'sslverify' => true
+        ));
+
+        // Check for errors
+        if (is_wp_error($response)) {
+            self::log_error('API request failed: ' . $response->get_error_message());
+            return $response;
+        }
+
+        // Parse response
+        $body = wp_remote_retrieve_body($response);
+        $data = json_decode($body, true);
+
+        if (json_last_error() !== JSON_ERROR_NONE) {
+            self::log_error('Invalid JSON response from WHMCS API');
+            return new WP_Error('invalid_response', __('Invalid response from WHMCS API', 'whmcs-pricing'));
+        }
+
+        // Check API result
+        if (isset($data['result']) && $data['result'] === 'error') {
+            $error_message = isset($data['message']) ? $data['message'] : __('Unknown API error', 'whmcs-pricing');
+            self::log_error('WHMCS API error: ' . $error_message);
+            return new WP_Error('api_error', $error_message);
+        }
+
+        return $data;
+    }
+
+    /**
+     * Get product details
+     */
+    public static function get_product($product_id) {
+        $cache_key = 'whmcs_product_' . $product_id;
+        $cached_data = get_transient($cache_key);
+
+        if (false !== $cached_data && !self::is_debug_mode()) {
+            return $cached_data;
+        }
+
+        // Make API request
+        $response = self::make_request('GetProducts', array(
+            'pid' => $product_id
+        ));
+
+        if (is_wp_error($response)) {
+            return $response;
+        }
+
+        // Extract product data
+        if (!isset($response['products']) || !isset($response['products']['product'])) {
+            self::log_error('Product not found: ' . $product_id);
+            return new WP_Error('product_not_found', __('Product not found', 'whmcs-pricing'));
+        }
+
+        $product_data = is_array($response['products']['product']) && isset($response['products']['product'][0])
+            ? $response['products']['product'][0]
+            : $response['products']['product'];
+
+        // Debug log the product data structure
+        if (self::is_debug_mode()) {
+            self::log_error('Product data for ID ' . $product_id . ': ' . print_r($product_data, true));
+        }
+
+        // Cache the result
+        $settings = self::get_settings();
+        set_transient($cache_key, $product_data, absint($settings['cache_duration']));
+
+        return $product_data;
+    }
+
+    /**
+     * Get product price
+     */
+    public static function get_price($product_id, $args = array()) {
+        $defaults = array(
+            'billing_cycle' => 'monthly',
+            'currency' => null,
+            'format' => 'default'
+        );
+
+        $args = wp_parse_args($args, $defaults);
+        $settings = self::get_settings();
+
+        // Use default currency if not specified
+        if (empty($args['currency'])) {
+            $args['currency'] = $settings['default_currency'];
+        }
+
+        // Get product data
+        $product = self::get_product($product_id);
+
+        if (is_wp_error($product)) {
+            return $product;
+        }
+
+        // Find pricing for the requested currency and billing cycle
+        $price = self::extract_price($product, $args['billing_cycle'], $args['currency']);
+
+        if (is_wp_error($price)) {
+            return $price;
+        }
+
+        // Format the price
+        return self::format_price($price, $args['currency'], $args['format']);
+    }
+
+    /**
+     * Extract price from product data
+     */
+    private static function extract_price($product, $billing_cycle, $currency) {
+        // Normalize billing cycle
+        $cycle_map = array(
+            'monthly' => 'monthly',
+            'quarterly' => 'quarterly',
+            'semiannually' => 'semiannually',
+            'annually' => 'annually',
+            'biennially' => 'biennially',
+            'triennially' => 'triennially',
+            'month' => 'monthly',
+            'quarter' => 'quarterly',
+            'year' => 'annually',
+            'annual' => 'annually'
+        );
+
+        $billing_cycle = strtolower($billing_cycle);
+        $billing_cycle = isset($cycle_map[$billing_cycle]) ? $cycle_map[$billing_cycle] : $billing_cycle;
+
+        // Debug pricing structure
+        if (self::is_debug_mode()) {
+            self::log_error("Looking for price: currency={$currency}, cycle={$billing_cycle}");
+            if (isset($product['pricing'])) {
+                self::log_error('Available pricing: ' . print_r($product['pricing'], true));
+            }
+        }
+
+        // Look for pricing in product data
+        if (isset($product['pricing'][$currency][$billing_cycle])) {
+            $price = floatval($product['pricing'][$currency][$billing_cycle]);
+
+            // WHMCS uses -1.00 to indicate billing cycle not available
+            if ($price < 0) {
+                if (self::is_debug_mode()) {
+                    self::log_error("Price is -1 (not available) for cycle: {$billing_cycle}");
+                }
+                return new WP_Error('price_not_available', __('This billing cycle is not available for this product', 'whmcs-pricing'));
+            }
+
+            if (self::is_debug_mode()) {
+                self::log_error("Found price: {$price}");
+            }
+            return $price;
+        }
+
+        // Try to find any available pricing and log it
+        if (self::is_debug_mode() && isset($product['pricing'])) {
+            self::log_error("Available currencies: " . implode(', ', array_keys($product['pricing'])));
+            if (isset($product['pricing'][$currency])) {
+                self::log_error("Available cycles for {$currency}: " . implode(', ', array_keys($product['pricing'][$currency])));
+            }
+        }
+
+        self::log_error("Price not found for product {$product['pid']}, cycle: {$billing_cycle}, currency: {$currency}");
+        return new WP_Error('price_not_found', __('Price not available for selected options', 'whmcs-pricing'));
+    }
+
+    /**
+     * Format price
+     */
+    private static function format_price($price, $currency, $format) {
+        $settings = self::get_settings();
+
+        // Apply decimal formatting
+        if ($format === 'no_decimals' || !$settings['show_decimals']) {
+            $price = round($price);
+            $formatted_price = number_format($price, 0);
+        } else {
+            $formatted_price = number_format($price, 2);
+        }
+
+        // Get currency symbol
+        $currency_symbol = self::get_currency_symbol($currency);
+
+        return array(
+            'raw' => $price,
+            'formatted' => $formatted_price,
+            'currency' => $currency,
+            'symbol' => $currency_symbol
+        );
+    }
+
+    /**
+     * Get currency symbol
+     */
+    private static function get_currency_symbol($currency) {
+        $symbols = array(
+            'USD' => '$',
+            'EUR' => '€',
+            'GBP' => '£',
+            'AUD' => 'A$',
+            'CAD' => 'C$',
+            'JPY' => '¥',
+            'CNY' => '¥',
+            'INR' => '₹',
+            'BRL' => 'R$',
+            'RUB' => '₽',
+            'CHF' => 'Fr',
+            'SEK' => 'kr',
+            'NOK' => 'kr',
+            'DKK' => 'kr',
+            'PLN' => 'zł',
+            'THB' => '฿',
+            'MYR' => 'RM',
+            'SGD' => 'S$',
+            'NZD' => 'NZ$',
+            'MXN' => 'Mex$',
+            'ZAR' => 'R'
+        );
+
+        return isset($symbols[$currency]) ? $symbols[$currency] : $currency;
+    }
+
+    /**
+     * Clear cache for specific product
+     */
+    public static function clear_cache($product_id) {
+        delete_transient('whmcs_product_' . $product_id);
+    }
+
+    /**
+     * Clear all cached products
+     */
+    public static function clear_all_cache() {
+        global $wpdb;
+
+        $wpdb->query(
+            "DELETE FROM {$wpdb->options}
+            WHERE option_name LIKE '_transient_whmcs_product_%'
+            OR option_name LIKE '_transient_timeout_whmcs_product_%'"
+        );
+    }
+
+    /**
+     * Check if debug mode is enabled
+     */
+    private static function is_debug_mode() {
+        $settings = self::get_settings();
+        return !empty($settings['debug_mode']);
+    }
+
+    /**
+     * Log error message
+     */
+    private static function log_error($message) {
+        if (self::is_debug_mode() && function_exists('error_log')) {
+            error_log('[WHMCS Pricing] ' . $message);
+        }
+    }
+}

whmcs-pricing-plugin/includes/shortcodes.php

@@ -0,0 +1,217 @@
+<?php
+/**
+ * Shortcode Handler
+ *
+ * Registers and processes shortcodes
+ */
+
+// Exit if accessed directly
+if (!defined('ABSPATH')) {
+    exit;
+}
+
+class WHMCS_Pricing_Shortcodes {
+
+    /**
+     * Single instance
+     */
+    private static $instance = null;
+
+    /**
+     * Translations cache
+     */
+    private static $translations = null;
+
+    /**
+     * Get instance
+     */
+    public static function get_instance() {
+        if (null === self::$instance) {
+            self::$instance = new self();
+        }
+        return self::$instance;
+    }
+
+    /**
+     * Constructor
+     */
+    private function __construct() {
+        add_shortcode('whmcs_price', array($this, 'render_price_shortcode'));
+    }
+
+    /**
+     * Load translations from JSON file
+     */
+    private static function load_translations() {
+        if (null !== self::$translations) {
+            return self::$translations;
+        }
+
+        $json_file = WHMCS_PRICING_PLUGIN_DIR . 'languages.json';
+
+        if (file_exists($json_file)) {
+            $json_content = file_get_contents($json_file);
+            self::$translations = json_decode($json_content, true);
+        }
+
+        if (!is_array(self::$translations)) {
+            self::$translations = array();
+        }
+
+        return self::$translations;
+    }
+
+    /**
+     * Render price shortcode
+     *
+     * @param array $atts Shortcode attributes
+     * @return string HTML output
+     */
+    public function render_price_shortcode($atts) {
+        // Parse attributes
+        $atts = shortcode_atts(array(
+            'product_id' => '',
+            'billing_cycle' => 'monthly',
+            'currency' => '',
+            'format' => 'default',
+            'show_cycle' => 'true',
+            'class' => '',
+            'lang' => 'english',
+            'language' => '' // Support both lang and language
+        ), $atts, 'whmcs_price');
+
+        // Validate product ID
+        if (empty($atts['product_id'])) {
+            return $this->render_error(__('Product ID is required', 'whmcs-pricing'));
+        }
+
+        // Sanitize attributes
+        $product_id = absint($atts['product_id']);
+        $billing_cycle = sanitize_text_field($atts['billing_cycle']);
+        $currency = !empty($atts['currency']) ? sanitize_text_field($atts['currency']) : '';
+        $format = sanitize_text_field($atts['format']);
+        $show_cycle = filter_var($atts['show_cycle'], FILTER_VALIDATE_BOOLEAN);
+        $custom_class = sanitize_html_class($atts['class']);
+
+        // Support both 'lang' and 'language' parameters
+        $lang = !empty($atts['language']) ? sanitize_text_field($atts['language']) : sanitize_text_field($atts['lang']);
+
+        // Get price from API
+        $price_data = WHMCS_Pricing_API::get_price($product_id, array(
+            'billing_cycle' => $billing_cycle,
+            'currency' => $currency,
+            'format' => $format
+        ));
+
+        // Check for errors
+        if (is_wp_error($price_data)) {
+            return $this->render_error($price_data->get_error_message());
+        }
+
+        // Render the price
+        return $this->render_price_html($price_data, $billing_cycle, $product_id, $show_cycle, $custom_class, $lang);
+    }
+
+    /**
+     * Render price HTML
+     *
+     * @param array $price_data Price data from API
+     * @param string $billing_cycle Billing cycle
+     * @param int $product_id Product ID
+     * @param bool $show_cycle Whether to show billing cycle
+     * @param string $custom_class Custom CSS class
+     * @param string $lang Language code
+     * @return string HTML output
+     */
+    private function render_price_html($price_data, $billing_cycle, $product_id, $show_cycle, $custom_class, $lang = 'english') {
+        $classes = array('whmcs-price');
+
+        if (!empty($custom_class)) {
+            $classes[] = $custom_class;
+        }
+
+        $cycle_text = $show_cycle ? $this->get_cycle_text($billing_cycle, $lang) : '';
+
+        $html = sprintf(
+            '<span class="%s" data-product-id="%d" data-cycle="%s">',
+            esc_attr(implode(' ', $classes)),
+            esc_attr($product_id),
+            esc_attr($billing_cycle)
+        );
+
+        $html .= sprintf(
+            '<span class="currency-symbol">%s</span>',
+            esc_html($price_data['symbol'])
+        );
+
+        $html .= sprintf(
+            '<span class="price-amount">%s</span>',
+            esc_html($price_data['formatted'])
+        );
+
+        if (!empty($cycle_text)) {
+            $html .= sprintf(
+                '<span class="billing-cycle">%s</span>',
+                esc_html($cycle_text)
+            );
+        }
+
+        $html .= '</span>';
+
+        return $html;
+    }
+
+    /**
+     * Get billing cycle text
+     *
+     * @param string $cycle Billing cycle
+     * @param string $lang Language code
+     * @return string Human-readable cycle text
+     */
+    private function get_cycle_text($cycle, $lang = 'english') {
+        $cycle = strtolower($cycle);
+
+        // Load translations
+        $translations = self::load_translations();
+
+        // Check if language exists, fallback to English
+        if (!isset($translations[$lang])) {
+            $lang = 'english';
+        }
+
+        // Get translated text
+        if (isset($translations[$lang][$cycle])) {
+            return ' ' . $translations[$lang][$cycle];
+        }
+
+        // Final fallback to English defaults
+        $defaults = array(
+            'monthly' => 'per month',
+            'quarterly' => 'per quarter',
+            'semiannually' => 'per 6 months',
+            'annually' => 'per year',
+            'biennially' => 'per 2 years',
+            'triennially' => 'per 3 years'
+        );
+
+        return isset($defaults[$cycle]) ? ' ' . $defaults[$cycle] : '';
+    }
+
+    /**
+     * Render error message
+     *
+     * @param string $message Error message
+     * @return string HTML output
+     */
+    private function render_error($message) {
+        // Only show errors to administrators
+        if (!current_user_can('manage_options')) {
+            return '<span class="whmcs-price whmcs-price-error" style="display:none;"></span>';
+        }
+
+        return sprintf(
+            '<span class="whmcs-price whmcs-price-error" style="color: #dc3232; font-style: italic;">[WHMCS Pricing Error: %s]</span>',
+            esc_html($message)
+        );
+    }
+}

whmcs-pricing-plugin/languages.json

@@ -0,0 +1,58 @@
+{
+  "english": {
+    "monthly": "per month",
+    "quarterly": "per quarter",
+    "semiannually": "per 6 months",
+    "annually": "per year",
+    "biennially": "per 2 years",
+    "triennially": "per 3 years"
+  },
+  "spanish": {
+    "monthly": "por mes",
+    "quarterly": "por trimestre",
+    "semiannually": "por 6 meses",
+    "annually": "por año",
+    "biennially": "por 2 años",
+    "triennially": "por 3 años"
+  },
+  "portuguese-pt": {
+    "monthly": "por mês",
+    "quarterly": "por trimestre",
+    "semiannually": "por 6 meses",
+    "annually": "por ano",
+    "biennially": "por 2 anos",
+    "triennially": "por 3 anos"
+  },
+  "dutch": {
+    "monthly": "per maand",
+    "quarterly": "per kwartaal",
+    "semiannually": "per 6 maanden",
+    "annually": "per jaar",
+    "biennially": "per 2 jaar",
+    "triennially": "per 3 jaar"
+  },
+  "french": {
+    "monthly": "par mois",
+    "quarterly": "par trimestre",
+    "semiannually": "par 6 mois",
+    "annually": "par an",
+    "biennially": "par 2 ans",
+    "triennially": "par 3 ans"
+  },
+  "german": {
+    "monthly": "pro Monat",
+    "quarterly": "pro Quartal",
+    "semiannually": "pro 6 Monate",
+    "annually": "pro Jahr",
+    "biennially": "pro 2 Jahre",
+    "triennially": "pro 3 Jahre"
+  },
+  "russian": {
+    "monthly": "в месяц",
+    "quarterly": "в квартал",
+    "semiannually": "за 6 месяцев",
+    "annually": "в год",
+    "biennially": "за 2 года",
+    "triennially": "за 3 года"
+  }
+}

whmcs-pricing-plugin/whmcs-pricing.php

@@ -0,0 +1,164 @@
+<?php
+/**
+ * Plugin Name: WHMCS Pricing
+ * Description: Display WHMCS product pricing via shortcodes. Lightweight, Elementor-compatible.
+ * Version: 1.0
+ * Author: ArkHost
+ * Author URI: https://arkhost.com
+ * Sponsored by: Duplika.com
+ * Text Domain: whmcs-pricing
+ * Domain Path: /languages
+ * Requires at least: 5.0
+ * Requires PHP: 7.4
+ * License: GPL v2 or later
+ */
+
+// Exit if accessed directly
+if (!defined('ABSPATH')) {
+    exit;
+}
+
+// Define plugin constants
+define('WHMCS_PRICING_VERSION', '1.0');
+define('WHMCS_PRICING_PLUGIN_DIR', plugin_dir_path(__FILE__));
+define('WHMCS_PRICING_PLUGIN_URL', plugin_dir_url(__FILE__));
+define('WHMCS_PRICING_PLUGIN_BASENAME', plugin_basename(__FILE__));
+
+/**
+ * Main plugin class
+ */
+class WHMCS_Pricing_Plugin {
+
+    /**
+     * Single instance of the class
+     */
+    private static $instance = null;
+
+    /**
+     * Get instance
+     */
+    public static function get_instance() {
+        if (null === self::$instance) {
+            self::$instance = new self();
+        }
+        return self::$instance;
+    }
+
+    /**
+     * Constructor
+     */
+    private function __construct() {
+        $this->load_dependencies();
+        $this->init_hooks();
+    }
+
+    /**
+     * Load required files
+     */
+    private function load_dependencies() {
+        require_once WHMCS_PRICING_PLUGIN_DIR . 'includes/api-handler.php';
+        require_once WHMCS_PRICING_PLUGIN_DIR . 'includes/shortcodes.php';
+
+        if (is_admin()) {
+            require_once WHMCS_PRICING_PLUGIN_DIR . 'includes/admin-settings.php';
+        }
+    }
+
+    /**
+     * Initialize hooks
+     */
+    private function init_hooks() {
+        add_action('plugins_loaded', array($this, 'load_textdomain'));
+
+        // Add settings link on plugins page
+        add_filter('plugin_action_links_' . WHMCS_PRICING_PLUGIN_BASENAME, array($this, 'add_settings_link'));
+
+        // Make author link open in new tab
+        add_filter('plugin_row_meta', array($this, 'modify_plugin_row_meta'), 10, 2);
+
+        // Initialize components
+        if (is_admin()) {
+            WHMCS_Pricing_Admin::get_instance();
+        }
+
+        WHMCS_Pricing_Shortcodes::get_instance();
+    }
+
+    /**
+     * Add settings link on plugins page
+     */
+    public function add_settings_link($links) {
+        $settings_link = '<a href="' . esc_url(admin_url('options-general.php?page=whmcs-pricing')) . '">' . __('Settings', 'whmcs-pricing') . '</a>';
+        array_unshift($links, $settings_link);
+        return $links;
+    }
+
+    /**
+     * Modify plugin row meta to open author link in new tab
+     */
+    public function modify_plugin_row_meta($links, $file) {
+        if ($file === WHMCS_PRICING_PLUGIN_BASENAME) {
+            // Add target="_blank" to author link
+            $links = array_map(function($link) {
+                if (strpos($link, 'arkhost.com') !== false) {
+                    return str_replace('<a href=', '<a target="_blank" rel="noopener noreferrer" href=', $link);
+                }
+                return $link;
+            }, $links);
+        }
+        return $links;
+    }
+
+    /**
+     * Load plugin textdomain
+     */
+    public function load_textdomain() {
+        load_plugin_textdomain('whmcs-pricing', false, dirname(WHMCS_PRICING_PLUGIN_BASENAME) . '/languages');
+    }
+
+    /**
+     * Activate plugin
+     */
+    public static function activate() {
+        // Set default options
+        $defaults = array(
+            'api_url' => '',
+            'api_identifier' => '',
+            'api_secret' => '',
+            'cache_duration' => 3600, // 1 hour
+            'default_currency' => 'USD',
+            'show_decimals' => true,
+            'debug_mode' => false
+        );
+
+        add_option('whmcs_pricing_settings', $defaults);
+    }
+
+    /**
+     * Deactivate plugin
+     */
+    public static function deactivate() {
+        // Clear all cached data
+        WHMCS_Pricing_API::clear_all_cache();
+    }
+}
+
+/**
+ * Activation hook
+ */
+register_activation_hook(__FILE__, array('WHMCS_Pricing_Plugin', 'activate'));
+
+/**
+ * Deactivation hook
+ */
+register_deactivation_hook(__FILE__, array('WHMCS_Pricing_Plugin', 'deactivate'));
+
+/**
+ * Initialize plugin
+ */
+function whmcs_pricing_init() {
+    return WHMCS_Pricing_Plugin::get_instance();
+}
+
+// Start the plugin
+whmcs_pricing_init();