Appearance

Frequently Asked Questions (FAQ) ​

Common questions and answers about installing, configuring, and using OmniSuite CMS.

Table of Contents ​

  1. Installation Questions
  2. Configuration Questions
  3. Usage Questions
  4. Technical Questions
  5. Troubleshooting Questions

Installation Questions ​

Q: What are the system requirements? ​

A: OmniSuite CMS requires:

  • PHP 8.2 or higher
  • MySQL 5.7+ / PostgreSQL 10+ / SQLite 3.8+
  • Composer
  • Node.js 18+ and NPM
  • Web server (Apache/Nginx)
  • 256MB+ PHP memory limit
  • 100MB+ free disk space

See System Requirements for details.

Q: Can I install on shared hosting? ​

A: Yes, OmniSuite CMS can be installed on shared hosting that meets the system requirements. cPanel hosting is fully supported. See cPanel Installation Guide.

Q: Do I need SSH access? ​

A: SSH access is helpful but not required. You can install via cPanel File Manager and use the web installer. However, SSH access makes installation faster and easier.

Q: How long does installation take? ​

A: Installation typically takes 10-30 minutes depending on:

  • Server speed
  • Internet connection
  • Installation method
  • Experience level

Configuration Questions ​

Q: How do I configure email settings? ​

A: Go to Settings → Email Settings and configure:

  • SMTP host, port, encryption
  • Username and password
  • From address and name
  • Test email sending

See Email Settings for details.

Q: How do I set up payment gateways? ​

A: Go to Settings → Payment Gateways and:

  1. Click Create New
  2. Select gateway (Stripe, PayPal, etc.)
  3. Enter API credentials
  4. Configure settings
  5. Test connection

See Payment Gateways for details.

Q: How do I enable SSL/HTTPS? ​

A:

  1. Obtain SSL certificate (Let's Encrypt is free)
  2. Install certificate on server
  3. Update .env: APP_URL=https://yourdomain.com
  4. Clear cache: php artisan config:clear

See Security Best Practices for details.

Usage Questions ​

Q: How do I create a new user? ​

A:

  1. Go to Users → Create New User
  2. Fill in user information
  3. Assign role(s)
  4. Set password
  5. Save user

See User Management for details.

Q: How do I add custom fields? ​

A:

  1. Go to module (e.g., Quotes)
  2. Click Custom Fields
  3. Click Create New Field
  4. Configure field (type, label, validation)
  5. Save field

See Custom Fields Management for details.

A:

  1. Go to Settings → General → Branding
  2. Upload logo
  3. Set logo dimensions
  4. Save settings

See General Settings for details.

Q: How do I create a blog post? ​

A:

  1. Go to Content → Blog Posts → Create New Post
  2. Enter title and content
  3. Add featured image
  4. Select category
  5. Set SEO settings
  6. Publish

See Blog Posts for details.

Technical Questions ​

Q: What database should I use? ​

A: OmniSuite CMS supports:

  • MySQL/MariaDB: Recommended, best compatibility
  • PostgreSQL: Full support
  • SQLite: For development/testing

MySQL is recommended for production.

Q: Can I use a different web server? ​

A: Yes, OmniSuite CMS works with:

  • Apache: Full support, mod_rewrite required
  • Nginx: Full support, recommended for performance
  • Other servers with PHP support

See installation guides for server-specific setup.

Q: How do I update the application? ​

A:

  1. Backup database and files
  2. Download latest version
  3. Replace files (keep .env and storage/)
  4. Run: composer install
  5. Run: php artisan migrate
  6. Clear cache

Always backup before updating!

Q: Can I customize the code? ​

A: Yes, but:

  • Keep customizations organized
  • Don't modify core files directly
  • Use custom fields and settings when possible
  • Document all changes
  • Test thoroughly

See Module Customization for details.

Troubleshooting Questions ​

Q: I get a 500 error after installation ​

A: Common causes:

  1. File permissions: Set correct permissions (755 for directories, 644 for files)
  2. .env file: Verify .env exists and is configured
  3. Cache: Clear cache: php artisan config:clear
  4. PHP version: Verify PHP 8.2+
  5. Error logs: Check storage/logs/laravel.log

See Troubleshooting Guide.

Q: Images won't upload ​

A: Check:

  1. File size: Check upload_max_filesize in php.ini
  2. Permissions: Verify storage/app/public is writable (775)
  3. Disk space: Check available disk space
  4. File types: Verify file type is allowed
  5. PHP settings: Check post_max_size and memory_limit

Q: Email not sending ​

A: Verify:

  1. SMTP settings: Check all SMTP settings are correct
  2. Credentials: Verify username/password
  3. Port/Encryption: Check port and encryption match
  4. Test email: Use test email function
  5. Server restrictions: Check if server blocks SMTP

See Email Settings.

Q: Payment gateway not working ​

A: Check:

  1. API keys: Verify keys are correct
  2. Sandbox/Live: Check if using correct mode
  3. Webhooks: Verify webhook URL configured
  4. SSL: Ensure SSL certificate is valid
  5. Gateway status: Check gateway service status

See Payment Gateways.

Q: Can't access admin panel ​

A: Check:

  1. URL: Verify correct admin URL
  2. Login: Check username/password correct
  3. Permissions: Verify user has access admin panel permission
  4. Role: Check user has appropriate role
  5. Cache: Clear browser cache

See User Management.

Additional Resources ​

Documentation ​

Support ​

  • Check documentation first
  • Review troubleshooting guides
  • Check error logs
  • Contact support if needed

Last Updated: [Date will be updated during final review]

Released under the MIT License.

Copyright © 2024 OmniSuite CMS