> ## Documentation Index
> Fetch the complete documentation index at: https://docs.areawp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# General Settings

> Configure your platform's core settings, company information, and system preferences

<Info>
  **Navigation Path:** Admin Dashboard → Settings → General Settings\
  **URL:** `/admin/GeneralOption`
</Info>

## Overview

Configure essential platform settings including contact options, company information, license management, and system automation.

<CardGroup cols={3}>
  <Card title="Contact Options" icon="message" color="#10b981">
    Customer contact methods
  </Card>

  <Card title="Company Setup" icon="building" color="#0d6efd">
    Business info and currency
  </Card>

  <Card title="Payment Gateway" icon="credit-card" color="#f59e0b">
    Payment methods
  </Card>

  <Card title="License" icon="key" color="#8b5cf6">
    Software license
  </Card>

  <Card title="Cron Jobs" icon="clock" color="#ef4444">
    Automated tasks
  </Card>

  <Card title="Languages" icon="language" color="#06b6d4">
    Multi-language support
  </Card>
</CardGroup>

***

## Contact Options

Configure how customers can reach you through various communication channels.

### Contact Form & Helpdesk

| Setting                 | Description                          |
| ----------------------- | ------------------------------------ |
| **Enable Contact Form** | Show contact form on website         |
| **Enable Helpdesk**     | Integrate with support ticket system |

### Dynamic Contact Buttons

Add up to 20 customizable contact buttons (WhatsApp, Facebook, Telegram, Email, etc.)

| Field                | Description        | Example                    |
| -------------------- | ------------------ | -------------------------- |
| **Button Title**     | Display text       | "Chat on WhatsApp"         |
| **Contact Link**     | URL or link        | `https://wa.me/1234567890` |
| **Background Color** | Button color (hex) | `#25D366`                  |

**Popular Links:**

* WhatsApp: `https://wa.me/PHONE`
* Facebook: `https://m.me/USERNAME`
* Telegram: `https://t.me/USERNAME`
* Email: `mailto:EMAIL@DOMAIN.COM`

**Popular Colors:**

* WhatsApp: `#25D366`, Facebook: `#1877F2`, Telegram: `#0088CC`, Email: `#EA4335`

<Tip>
  Limit to 3-5 contact options to avoid overwhelming visitors. Use recognizable brand colors and test all links before publishing.
</Tip>

***

## Company Setup

Configure your business information and platform-wide settings.

### Currency

Select your default currency for transactions and pricing.

Available: USD ($), EUR (€), GBP (£), VND (₫), JPY (¥), AUD (A$), CAD (C\$)

<Warning>
  Changing currency after setting up pricing may affect existing products. Make this change carefully and update all pricing accordingly.
</Warning>

### Company Information

| Field                | Required | Description         |
| -------------------- | -------- | ------------------- |
| **Company Name**     | ✅ Yes    | Legal business name |
| **Business Address** | No       | Physical address    |
| **City**             | No       | Business location   |
| **Phone Number**     | No       | Contact phone       |
| **Business Email**   | ✅ Yes    | Official email      |
| **VAT/Tax ID**       | No       | Tax identification  |

### Website Settings

| Setting                    | Default  | Description                     |
| -------------------------- | -------- | ------------------------------- |
| **Search Engine Indexing** | Enabled  | Allow Google to index your site |
| **Show Documentation**     | Enabled  | Display docs on homepage        |
| **Disable Landing Page**   | Disabled | Skip landing, go to login       |

### Tax Management

| Setting          | Description                            |
| ---------------- | -------------------------------------- |
| **Enable Tax**   | Master toggle for tax functionality    |
| **Tax Label**    | Name (e.g., "VAT", "GST", "Sales Tax") |
| **Tax Rate (%)** | Percentage to apply (e.g., 20 for 20%) |

<Tip>
  Check your local tax regulations before enabling. Ensure your tax rate is accurate and up-to-date. Consider consulting with a tax professional for complex scenarios.
</Tip>

### User Registration

| Setting                | Default  | Description                    |
| ---------------------- | -------- | ------------------------------ |
| **Allow Registration** | Disabled | Enable public account creation |

<Warning>
  Disabling user registration will prevent new customers from signing up. Only enable this if you want to control who can create accounts.
</Warning>

***

## Payment Gateway

<Card title="Payment Configuration Guide" icon="credit-card" href="/payment-configuration">
  Configure Bank Accounts, Stripe, and PayPal. View the comprehensive **Payment Configuration** guide for detailed setup.
</Card>

<Info>
  The Payment Gateway tab allows you to configure multiple payment methods for processing customer transactions. For detailed setup instructions, API key configuration, and webhook setup, please refer to the dedicated [Payment Configuration](/payment-configuration) documentation.
</Info>

**Quick Overview:**

* **Bank Account**: Up to 20 accounts for manual transfers
* **Stripe**: Automated credit card processing
* **PayPal**: PayPal checkout with sandbox/live modes

***

## License Settings

Manage and validate your software license to ensure continued access to updates and support.

**How to Validate Your License:**

1. Enter your license key in the provided field
2. Click the validation button to verify your license
3. Review your license status, expiration date, and website count
4. If your license is expired or expiring soon, renew it to maintain access

**License Information Displayed:**

* ✅ License Status (Active, Expired, Invalid)
* ✅ Expiration Date
* ✅ Website Count
* ✅ Domain Verification

<Warning>
  **Important:**

  * Keep your license key secure and confidential
  * Validate your license regularly to ensure it's active
  * Renew before expiration to avoid service interruptions
  * Contact support if you encounter validation errors
</Warning>

<Tip>
  Set a reminder to renew your license before it expires. Keep a backup copy of your license key in a secure location. Validate your license after any major system updates.
</Tip>

***

## Cron Automation

Configure automated tasks to run on a schedule, improving efficiency and reducing manual work.

### What is Cron Automation?

Cron automation allows you to schedule recurring tasks that run automatically at specified intervals. This is essential for database cleanup, email notifications, report generation, and data synchronization.

**Setting Up Cron Jobs:**

1. Copy the cron endpoint URL from the Cron Automation tab
2. Log in to your server's control panel (cPanel, Plesk, etc.)
3. Add a new cron job with the URL you copied
4. Configure how often the cron should run (e.g., every hour, daily)
5. Verify the cron job runs successfully

<Info>
  **Recommended Schedule:** Run cron jobs every 5-15 minutes for optimal performance. Adjust based on your specific needs and server resources.
</Info>

<Tip>
  Start with a longer interval (e.g., hourly) and adjust as needed. Monitor server resources to ensure cron jobs don't overload your system. Set up logging to track cron job execution and errors.
</Tip>

***

## Language Settings

Configure multi-language support to serve customers in their preferred language.

**Features:**

* 🌍 Multiple languages
* ↔️ RTL support (Arabic, Hebrew)
* 📝 Language-specific content
* 🔄 Auto-detection
* ✏️ Custom translations

**Language Configuration:**

1. Choose which languages to enable on your platform
2. Upload language files or use the built-in translation editor
3. Set the default language for new visitors
4. Optionally enable automatic language detection based on browser settings
5. Verify all languages display correctly on your website

<Tip>
  Enable auto-detection to serve content in visitors' preferred language. Provide a language switcher for manual selection. Ensure all critical content is translated. Keep translations up-to-date when adding new features.
</Tip>

***

## Best Practices

<AccordionGroup>
  <Accordion title="Configuration Management" icon="gear">
    * Document all configuration changes
    * Test settings in a staging environment first
    * Back up your configuration before major changes
    * Review settings quarterly to ensure they're still appropriate
    * Make one change at a time to identify issues easily
    * Notify your team before making significant changes
    * Keep a log of who changed what and when
  </Accordion>

  <Accordion title="Security Considerations" icon="shield">
    * Never share your license key publicly
    * Keep API keys and secrets secure
    * Use strong passwords for admin accounts
    * Enable two-factor authentication if available
    * Limit admin access to trusted team members only
    * Review admin user list regularly
    * Remove access for former employees immediately
  </Accordion>

  <Accordion title="Performance Optimization" icon="gauge">
    * Set appropriate cron job intervals
    * Monitor server resources regularly
    * Disable unused features to reduce overhead
    * Keep your software updated for performance improvements
    * Run database cleanup cron jobs regularly
    * Archive old data instead of deleting
    * Optimize database tables periodically
  </Accordion>

  <Accordion title="Customer Experience" icon="user">
    * Provide multiple contact options
    * Keep company information up-to-date
    * Enable search engine indexing for visibility
    * Offer language options for international customers
    * Respond to contact form inquiries promptly
    * Keep helpdesk tickets organized
    * Set clear expectations for response times
  </Accordion>
</AccordionGroup>

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="License Validation Fails" icon="key">
    **Issue:** License key shows as invalid or expired

    **Solutions:**

    1. Verify license key is copied correctly (no extra spaces)
    2. Check license expiration date
    3. Ensure domain matches the one registered for the license
    4. Try validating again after a few minutes
    5. Contact support if issue persists
  </Accordion>

  <Accordion title="Cron Jobs Not Running" icon="clock">
    **Issue:** Automated tasks are not executing

    **Solutions:**

    1. Verify cron job is set up in server control panel
    2. Check cron URL is correct and accessible
    3. Review server logs for errors
    4. Ensure server has enough resources
    5. Test cron URL manually in browser
  </Accordion>

  <Accordion title="Contact Buttons Not Appearing" icon="message">
    **Issue:** Contact buttons don't show on website

    **Solutions:**

    1. Save contact button configuration again
    2. Clear browser and server cache
    3. Check browser console for JavaScript errors
    4. Verify theme supports contact buttons
    5. Test on different browsers
  </Accordion>

  <Accordion title="Currency Changes Not Reflecting" icon="dollar-sign">
    **Issue:** Currency change doesn't update prices

    **Solutions:**

    1. Clear all caches (browser, server, application)
    2. Refresh pricing pages
    3. Update product prices manually if needed
    4. Check theme currency settings
    5. Verify database currency field is updated
  </Accordion>
</AccordionGroup>

***

## Quick Reference

### Common Tasks

| Task               | Steps                                                  |
| ------------------ | ------------------------------------------------------ |
| Add Contact Button | Contact Button tab → Add button → Enter details → Save |
| Change Currency    | Company Setup → Select currency → Save                 |
| Enable Tax         | Company Setup → Enable tax → Set rate → Save           |
| Validate License   | License Settings → Enter key → Validate                |
| Setup Cron         | Cron Automation → Copy URL → Add to server             |
| Add Language       | Language Settings → Select → Upload files              |

### Important Settings

| Setting           | Default  | Recommendation              |
| ----------------- | -------- | --------------------------- |
| Search Indexing   | Enabled  | Keep enabled                |
| User Registration | Disabled | Enable only if needed       |
| Tax Management    | Disabled | Enable based on regulations |
| Contact Form      | Enabled  | Keep enabled                |

***

## Related Documentation

<CardGroup cols={2}>
  <Card title="Payment Configuration" icon="credit-card" href="/payment-configuration">
    Payment gateways and billing
  </Card>

  <Card title="Website Configuration" icon="globe" href="/website-configuration">
    Website creation settings
  </Card>

  <Card title="Domain API Settings" icon="globe" href="/domain-api-settings">
    Domain registration API
  </Card>

  <Card title="User Roles & Permissions" icon="shield-lock" href="/permission-settings">
    Access control
  </Card>
</CardGroup>
