docs.profitweb.site

ProfitWeb Engine Documentation

This documentation is designed to help you set up ProfitWeb Engine from the ground up and get it fully running: from uploading files, creating the database, and completing the installer to configuring API keys, site settings, keywords, prompts, content generation, and the SEO Engine workflow.

The structure is intentionally arranged so beginners can follow it with confidence while advanced users can move faster without missing key settings. Follow the guide from top to bottom for the smoothest setup.

Quick Start

  1. Upload the files to your hosting account and create a database.
  2. Run install.php and enter your license key.
  3. Add at least one active API key in API Keys & Generation Settings.
  4. Complete Site Setup and choose your theme.
  5. Add keywords and run your first content generation test.

Start Here

If this is your first time using ProfitWeb Engine, follow the setup order below so you can move faster without missing the parts that matter most.

Recommended Setup Order

The safest order after installation is:

  1. License
  2. API Keys
  3. Site Setup
  4. Themes
  5. Keyword Manager
  6. Content Prompts
  7. Generate Content Manually
  8. Enable automated content generation from the Cron Setup block inside Generate Content Manually, then review the results in Cron Logs

Common Mistakes

  • Trying to generate content before adding an API key.
  • Running content generation before adding any keywords.
  • Using the system while the license is inactive, which blocks manual and cron actions.
  • Expecting automatic publishing before the cron job has been configured.

Recommended First Test

  • Enable one active AI provider.
  • Add 3 to 5 keywords first.
  • Use the default prompt Universal Niche Prompt v3.
  • Run Generate 1 Article before enabling cron.

1. Preparation

Before you install ProfitWeb Engine, make sure the following essentials are ready:

  • An active domain, for example yourdomain.com
  • Hosting that supports PHP and MySQL/MariaDB
  • Access to your hosting File Manager or FTP
  • Access to phpMyAdmin or your hosting database tools
  • At least one active AI API key for content generation
ProfitWeb Engine is built to stay lightweight. In many cases, it runs well even on small shared hosting plans as long as the basic hosting environment is healthy and the database is accessible.

2. Upload Files to Hosting

1

Prepare your ProfitWeb Engine package

Keep the ProfitWeb Engine files ready on your computer before uploading them.

2

Upload to public_html or your domain folder

Upload all files into your website root, for example:

/public_html/

or, if you use an addon domain:

/public_html/domainanda.com/
3

Extract the package if it is still zipped

If you uploaded a ZIP file, extract everything until you can see folders such as config, core, modules, templates, public, and the install.php file.

Make sure the files are placed in the actual website root. If they end up inside an extra subfolder, the installer URL may not open correctly.

3. Create a Database

Inside your hosting panel, create the following:

  • A database name
  • A database username
  • A database password

After that, assign the database user to the database and grant ALL PRIVILEGES.

You will need these details during installation:
DB Host, DB Name, DB User, and DB Password.

4. Manual Database Import

Under normal conditions, install.php imports database.sql automatically. If you prefer to do it yourself, use the steps below:

1

Open phpMyAdmin

Select the database you created earlier.

2

Choose the Import menu

Upload the following file from your ProfitWeb Engine package:

database.sql
3

Complete the import

If the import succeeds, core tables such as posts, keywords, categories, pages, and settings should appear.

This manual import is optional. If the installer works normally, you can simply use install.php and let the system import the database automatically.

5. Run the Installer

Once the files are uploaded and the database is ready, open the installer URL in your browser:

https://yourdomain.com/install.php

On the installer page, fill in the following details:

  • Host: usually localhost
  • Database Name
  • Database Username
  • Database Password
  • Blog URL: for example https://yourdomain.com
  • License Key: enter the key you received after purchase
  • Admin Username
  • Admin Password
  • Cron Secret: leave the auto-generated value unless you want to set your own

After everything is filled in, click the install button. The site language is set to English by default and can be changed later from Site Setup.

If the process succeeds, the installer creates the configuration file in config/config.php, fills the base settings table, and points you to the next setup steps such as Site Setup, Categories, Keywords, and your first generated article.
After installation is complete, remove this file:
install.php
from your hosting account for security.

6. After Installation

This is the most recommended setup order after the installer is complete:

1

Sign in to the admin panel

Open:

https://yourdomain.com/admin/
2

Check Dashboard and License

Confirm that the license is active, then review the initial setup summary in the admin dashboard.

3

Complete Site Setup

Set your site name, description, tagline, author names, and other core identity settings.

4

Add your API keys

Without an active API key, content generation will not run properly.

5

Choose your theme

Select the theme that best fits your niche and presentation style.

6

Add categories and keywords

Enter the categories and keywords you want to use for content generation.

7

Generate your first piece of content

Open Generate Content Manually and run your first article to verify that everything is working correctly.

7. Dashboard

The Dashboard is your main control overview once you enter the admin area.

  • Review the License Status at the very top
  • Use the Launch Checklist to confirm the base setup is complete
  • Check published articles, active keywords, total views, and today’s post count
  • Use Quick Actions to jump directly into API Keys, Site Setup, Keyword Manager, or Generate Content Manually
  • Review recent articles and the latest cron activity without opening another menu

8. License

This menu is used to manage the ProfitWeb Engine license for the domain currently running the script.

  • Save or replace your License Key
  • Activate the license for the current domain using Activate License
  • Use Validate Now to refresh the current license status
  • Use Deactivate License before moving the installation to another domain
  • Review the current status, plan type, active domain, and the latest validation message
If the license is inactive, manual content generation and automated publishing will remain blocked until the license becomes active again.

9. Site Setup

Use this menu to define your website’s main identity. The most important fields to complete are:

  • Site Name: your website name
  • Tagline: a short supporting line
  • Site Description: your main website description
  • Author Names: the author names used across the site
  • Copyright Text
  • Logo URL and Favicon URL
  • Default Meta Keywords
  • Google Verification
  • Twitter/X Handle
  • GA Tracking ID
If you want a faster start, use the One Click Setup button on this page. Before using it, make sure you already have at least one active API key saved in API Keys & Generation Settings.

10. Themes

The Themes menu is where you choose the visual direction of your site.

  • Choose the theme that best matches your niche and audience
  • Adjust the Dominant Color so the site feels closer to your brand
  • Use the previews to understand the personality of each theme before applying it

The currently available themes include:

ProfitPro, ProfitPro Dark, AuroraFlow, CleanWave, Minimal Clean, SimpleFast, SimpleFast Dark, Mono Press, Classic Blog, News Portal, Noir Dark, Cobalt Dark, Ember Dark
Some themes are built for speed, some are more editorial in tone, and others are designed to make the visual presentation more distinctive. Pick the one that fits your project best.

This theme library will continue to grow with new updates over time.

11. API Key Providers & Generation Settings

This is one of the most important menus in the system. It is where you connect your AI providers and define how ProfitWeb Engine generates content.

Supported AI Providers

OpenAI

For GPT-based models.

Get your API key: OpenAI API docs and OpenAI API keys

Gemini

For Google Gemini models.

Get your API key: Gemini quickstart and Google AI Studio

Groq

For fast models served through OpenAI-compatible endpoints.

Get your API key: Groq API Keys

OpenRouter

For access to multiple models from one place.

Get your API key: OpenRouter API Authentication

DeepSeek

For DeepSeek API models.

Get your API key: DeepSeek API Docs

Pexels

For image sourcing through the Pexels API.

Get your API key: Pexels API and How to get an API key

What Should You Configure Here?

  • Add the API keys for the providers you want to use
  • Select the model when a model field is available
  • Set your Minimum Words
  • Choose how many posts should be processed in a single run
  • Add the providers you want to use, then choose the provider or provider chain that best fits your workflow
  • Adjust Generation Mode based on the content source you want to use
  • Enable Content Quality Gate if you want stricter control before publishing
  • Enable Auto Publish if you want articles published automatically
  • Choose your image source, such as Bing Image, Pexels, Gemini AI Image, or OpenAI Image
At a minimum, you only need one active AI provider. However, the more providers you connect, the more flexible and resilient your generation workflow becomes.

API Key Rotation

ProfitWeb supports multiple API keys for several providers. You can add more than one key, one key per line, and the system will rotate them automatically.

  • Very useful for free-tier setups so all requests do not hit the same account constantly
  • Helps keep your workflow running when one key reaches its limit
  • Can be used with Gemini, OpenAI, Groq, OpenRouter, DeepSeek, and Pexels
  • Use the built-in provider test buttons to confirm every key is active

Recommended API Setup

100% Free Setup

If your goal is to keep costs as close to zero as possible, the safest route is to use Groq as your text-generation provider and Bing Image as your image source.

  • Use Groq as the only AI provider for text generation
  • Create several API keys with different email accounts if needed, then load them into the system so they can rotate automatically
  • Use Bing Image for visuals so you avoid extra API costs and additional storage pressure on your server

Balanced to Premium Setup

If you want stronger and more consistent results, use Gemini or OpenAI as your primary provider.

  • Gemini offers a free tier, but in many cases your Google account still needs billing set up properly
  • Gemini AI Image can also run on the free tier, but the account setup still needs to be configured correctly
  • If you have more budget, use paid Gemini or paid OpenAI for stronger overall quality and stability

Free vs Paid AI

Free AI

  • Plus: very low entry cost, ideal for early testing and projects you want to launch without much overhead
  • Plus: useful for niche experiments, keyword validation, and early-stage builds
  • Minus: limits are reached faster, performance is not always stable, and output quality can vary more
  • Minus: you may need multiple keys and rotation to keep the workflow smooth

Paid AI

  • Plus: results are usually stronger, more stable, and more consistent for larger-scale use
  • Plus: more comfortable for serious projects, monetization, and long-term workflows
  • Minus: operating costs are higher
  • Minus: usage should be monitored so your budget stays efficient
In general, paid AI tends to deliver stronger and more stable results. That said, a free setup is still more than enough for many users who want to start lean, test niches, and build an initial foundation first.

AI Image Generation: Gemini and OpenAI

ProfitWeb supports article image generation through Gemini AI Image and OpenAI Image. Both can produce visuals that feel more unique, more relevant to the topic, and less dependent on generic stock imagery.

  • Add your Gemini API Key or OpenAI API Key first in the matching provider section
  • Set Article Image Source to Gemini AI Image or OpenAI Image
  • If you choose Gemini, you can adjust the model, style, image count, and fallback
  • If you choose OpenAI, you can adjust the model, image count, and fallback
  • By default, AI image fallback is set to No fallback
  • Use Test Gemini Image Generation or Test OpenAI Image Generation to confirm that image generation is working correctly
If you want more control over the visual output, open Content Prompts and fill in the Custom Image Prompt. This prompt is used when AI image generation is active.

Image Source Recommendation

Gemini AI Image

  • Plus: visuals can feel more unique, more topic-relevant, and more exclusive than ordinary stock images
  • Plus: a strong choice if you want article visuals to feel more distinctive and more branded
  • Minus: more expensive than standard image sources
  • Minus: uses more server storage because the generated files are saved on your hosting account

OpenAI Image

  • Plus: image output can feel cleaner, more unique, and better suited for polished article visuals
  • Plus: a practical choice if you want to keep both text and image generation inside the OpenAI workflow
  • Minus: still adds API cost
  • Minus: generated files are saved on your hosting account, so storage usage still matters

Bing Image / Pexels

  • Plus: more budget-friendly and lighter for day-to-day workflows
  • Plus: well suited for larger article volume without putting fast pressure on your budget
  • Minus: visuals can feel more generic and are not always as unique as AI-generated images
  • Minus: image relevance sometimes requires more manual filtering
If your main priority is efficiency, use Bing Image or Pexels. If your priority is stronger branding and more unique visuals, use Gemini AI Image or OpenAI Image while keeping a close eye on cost and storage usage.

12. Keyword Manager

This menu is used to manage the keywords that feed your content generation workflow.

What You Can Do Here

  • Add keywords one by one
  • Import keywords in bulk
  • Save your main niche
  • Auto-generate new keywords
  • Enable Keyword Magic
  • Clean up keywords that have already been used

How to Add Keywords Manually

1

Open Keyword Manager

Go to Configuration > Keyword Manager.

2

Enter the keyword

Add the keyword you want to target, then choose the language and niche if needed.

3

Save it

Once saved, the keyword will appear in the list and be ready for Generate Content Manually.

How to Import Keywords in Bulk

Paste your keyword list, one keyword per line, and then run the import.

How to Auto-Generate Keywords

Use the Auto Generate feature to create new keywords automatically. If Keyword Magic is enabled, the system will lean more toward long-tail opportunities with stronger demand signals and lighter competition.

13. Content Prompts

This menu lets you manage article prompts and image prompts, especially if you are using AI image generation such as Gemini AI Image or OpenAI Image.

  • Select your default prompt
  • Create custom prompts
  • Edit existing prompts
  • Choose the active prompt used during generation
  • Configure a Custom Image Prompt for AI image generation
  • Use Show/Edit to reveal the full prompt only when you need it

If you prefer to keep things simple, start with the built-in prompt:

Universal Niche Prompt v3
Universal Niche Prompt v3 is currently the main default prompt and is selected automatically as the built-in active prompt.

If you want a different tone or structure, create a new prompt that matches your niche, search intent, or preferred writing style.

Custom Image Prompt

The Custom Image Prompt block helps control the visuals generated by AI image generation. It gives you a more consistent look, a closer fit to your niche, and stronger relevance to the topic being processed.

  • This prompt is only used when Article Image Source is set to Gemini AI Image or OpenAI Image
  • If this field is empty, the system will use the built-in default image prompt automatically
  • Use a clear visual direction such as editorial, realistic, clean, cinematic, or modern illustration
{topic} | {style_text} | {index} | {total}

The variables above can be used to make your image prompt more dynamic. For example, {topic} injects the article topic, {style_text} controls the visual style, and {index} or {total} can be used when generating multiple image variations for a single article.

14. Generate Content Manually

This menu is used for manual content generation whenever you want direct control over the process.

How to Generate Content Manually

1

Make sure an API key is active

At least one AI provider must be active before you start.

2

Make sure keywords are available

You should already have active keywords in Keyword Manager.

3

Open Generate Content Manually

Choose how many articles you want to process in one run.

4

Click the generate button

The system will pull a keyword, call the AI provider, build the draft, run the quality gate, and publish the article if it passes the required checks.

If content is not generated successfully, the most common reasons are:
  • The API key is invalid
  • The keyword list is empty or exhausted
  • The AI provider is temporarily failing
  • The Quality Gate is set too aggressively

Available Generate Options

  • Generate 1 Article: the safest option for an initial test
  • Generate 3 Articles: a good option for a light production run
  • Generate 5 Articles: best used once the whole setup is already stable
This page also includes a Cron Setup block with a ready-to-use cron command for your hosting environment.

15. All Posts, Categories, and Pages

Once content starts publishing, these menus will become part of your daily workflow:

  • All Posts: review all published or drafted articles with filtering and pagination
  • Categories: organize your site structure by topic
  • Pages: manage static pages such as About, Contact, Privacy Policy, Disclaimer, and similar essentials

It is a good idea to complete your core categories and static pages early so the site feels more complete from the start.

16. SEO Engine

This section contains the tools related to SEO, discovery, and long-term content maintenance.

Indexing Strategy

Controls indexing and discovery paths so new content can be found more quickly.

Internal Links

Helps strengthen your internal linking structure so related articles support one another.

Content Quality

Keeps article quality under control before publishing so weak output is filtered out.

Topic Clusters

Groups content around larger themes so the site becomes more structured for SEO.

Content Refresh

Helps refresh older content so it stays relevant instead of gradually decaying.

What You Can Do in SEO Engine

  • Indexing Strategy: choose your indexing mode, enable the workflow, and monitor logs plus queue boosters
  • Internal Links: watch your internal link structure and anchor diversity across articles
  • Content Quality: review generation quality, recurring issues, and topics that are frequently rejected
  • Topic Clusters: build clusters manually or use Smart Topic Clusters so the system creates the structure for you
  • Content Refresh: scan older articles, queue refresh jobs, and run periodic maintenance

17. Ad Placement

Use this menu to control where ads appear across your website.

  • Add scripts from AdSense, Adsterra, or other ad networks
  • Control the placement of each ad slot
  • Use Sticky Bottom Banner if you want a floating banner across all public pages
  • The sticky banner includes an X close button in the top-right corner
  • The sticky banner size is flexible and follows the size of your banner or image asset
  • You can reuse the same ad code in multiple slots if needed
  • Keep the active theme and reader experience in mind when placing ads
Keep ad placement reasonable. The goal is not only to improve monetization, but also to keep the reading experience comfortable.

18. Cron Logs & Cron Runner

To run ProfitWeb Engine automatically, you need to add a cron job on your hosting account.

A typical command looks like this:

*/30 * * * * php /path/to/your/site/cron-runner.php secret=YOUR_CRON_SECRET

If your hosting uses cPanel, open the Cron Jobs section and paste the command there.

Replace /path/to/your/site/ with the correct server path. If you are not sure what it is, check your File Manager or ask your hosting support team.

After cron is active, open Cron Logs in the admin area to review run history, processed article counts, and any errors that need attention.

19. Troubleshooting

If something is not working as expected, use the guide below to check the most common causes first.

The installer will not continue

This usually happens because the database details are incorrect, the files are not in the website root, or the license key is not valid. Recheck the database host, username, password, and confirm that the license key matches your purchase.

Cannot connect to license server

Check whether your license server domain is active, whether the license plugin is running properly, and whether the license endpoint can be reached. If your license server is installed on the main domain, make sure ProfitWeb points to that domain correctly.

An API key is saved but generation still fails

Use the provider test buttons in API Keys & Generation Settings to confirm the key is actually active. If the test fails, the key may be incorrect, the provider may be rate-limited, or the selected model may not be available for that account.

AI image generation is not returning images

Make sure the API key for your selected image provider is valid, Article Image Source is set to Gemini AI Image or OpenAI Image, the selected model is available, and your image prompt is not empty or confusing. If needed, switch the fallback to Bing Image.

Keywords exist, but articles are not being published

Check whether the quality gate is too strict, whether active keywords are still available, and whether the license is active. If content is being created as drafts, review the results in All Posts.

Cron is not running automatically

Check the cron command, the path to cron-runner.php, and the cron secret. Then review Cron Logs to confirm whether the hosting environment is calling the command at all.

The license was active before, but now it is inactive

Open the License menu and click Validate Now. If it still fails, check the connection to the license server and confirm that the license has not been blocked, moved, or used beyond the domain limit of your plan.

Ads are not showing in a specific slot

Make sure the ad code was saved correctly in Ad Placement. If you are testing the sticky bottom banner, also check whether the banner was manually closed in that browser session.

20. FAQ

Is ProfitWeb Engine difficult to install?

No. In most cases, you only need to upload the files, create the database, open install.php, fill in the required details, and then continue to the admin panel.

Do I have to import the database manually?

No. The installer will usually import database.sql automatically. Manual import is only needed if you want to do it yourself or the installer fails.

What do I need to get started?

A domain, hosting, a MySQL/MariaDB database, and at least one AI API key.

Can it run on small shared hosting?

Yes. ProfitWeb Engine is designed to stay lightweight, so in many cases it runs very well on small shared hosting plans.

Do I need a VPS?

No. You can start on shared hosting and upgrade later if your traffic and workload grow.

Do I need to start with paid AI right away?

No. You can start with providers that offer a free tier, then move to paid providers once you want stronger or more stable output.

Can I change the prompts myself?

Yes. The Content Prompts menu is built for exactly that. You can use the default prompt, create custom prompts, or manage multiple prompts as needed.

Can article images be generated with AI?

Yes. When you enable Gemini AI Image or OpenAI Image, ProfitWeb can generate article images that feel more unique and more relevant to the topic.

Do I have to use only one API key?

No. ProfitWeb supports multiple API keys and key rotation, so you can add several keys for the same provider.

Can I move the license to another domain?

Yes. Open the License menu and use Deactivate License before moving the installation to another domain.

Is it limited to a single niche?

No. You can work with different niches depending on the project you are building.

Need Help?

If you have already followed the installation guide, setup steps, and troubleshooting notes but still need help, you can contact support on Telegram HERE.

When reaching out, it helps to include a short summary of the issue, what you already tried, and a screenshot when needed so support can help you faster.