📚 Documentation

Multi Social Media Content Generator - User Guide

🚀 Quick Start

Get up and running in 5 minutes with this quick start guide.

  1. Upload to your hosting: Extract the ZIP file and upload the social-generator folder to your public_html directory.
  2. Access the application: Navigate to yourdomain.com/social-generator/
  3. Login to Admin Panel: Click "Admin" button and login with default credentials.
  4. Configure API Key: In Admin Panel, go to "API Settings" and enter your OpenRouter API key.
  5. Generate content: Go back to main app, enter your text and click "Generate Content"!

🔐 Admin Panel

Default Login Credentials

Username: admin

Password: social-generator

⚠️ Important: Change these credentials immediately after your first login for security!

Accessing the Admin Panel

  1. Click the Admin button in the top-right corner of the application.
  2. Enter the default username and password.
  3. On first login, you'll be prompted to change your credentials.

Admin Panel Features

Payment Button Configuration

The Admin Panel allows you to add a payment button to the main application:

📦 Installation on cPanel

Step 1: Download and Extract

  1. Download the social-generator.zip file to your computer.
  2. Log in to your cPanel account.
  3. Open the File Manager.
  4. Navigate to public_html directory.
  5. Click Upload and select the ZIP file.
  6. Once uploaded, right-click the ZIP file and select Extract.

Step 2: Verify Installation

After extraction, you should see this folder structure:

public_html/
└── social-generator/
    ├── index.html
    ├── assets/
    │   ├── css/
    │   │   └── style.css
    │   └── js/
    │       └── app.js
    ├── backend/
    │   └── generate.php
    ├── README.html
    └── .htaccess

Step 3: Test the Application

Visit https://yourdomain.com/social-generator/ in your browser. You should see the application interface.

💡 Tip: Make sure your hosting has PHP 7.4 or higher installed. Most shared hosting providers support this by default.

🔑 OpenRouter API Key Setup

Getting Your API Key

  1. Go to openrouter.ai
  2. Create an account or sign in.
  3. Navigate to openrouter.ai/keys
  4. Click Create Key to generate a new API key.
  5. Copy the key (it starts with sk-or-).

Entering Your API Key

  1. Click the Admin button in the top-right corner.
  2. Login with your admin credentials.
  3. Go to the API Settings tab.
  4. Paste your API key in the "OpenRouter API Key" field.
  5. Select your preferred AI model.
  6. Click Save API Settings.

⚠️ Security Note: Your API key is stored securely on the server and is never exposed to end users. Only admins can view or modify the API settings.

🤖 Selecting AI Models

The application supports multiple AI models through OpenRouter. Choose based on your needs and budget:

Free Models

Model Best For
Llama 3.2 3B Instruct Quick, basic content generation
Llama 3.1 8B Instruct Better quality, still free
Gemma 2 9B Google's efficient model
Mistral 7B Instruct Good balance of speed and quality

Paid Models (Higher Quality)

Model Best For
GPT-4o Best overall quality and creativity
GPT-4o Mini Good quality at lower cost
Claude 3.5 Sonnet Excellent writing and nuance
Gemini Pro 1.5 Fast with great context handling

💡 Recommendation: Start with free models for testing. Use paid models like GPT-4o or Claude 3.5 Sonnet for production content that needs to be high quality.

📝 How to Generate Content

Option 1: Text Input

  1. Click on the Text Input tab.
  2. Paste or type your content in the textarea.
  3. Watch the word counter (maximum 5,000 words).
  4. Click Generate Content.

Option 2: File Upload

  1. Click on the File Upload tab.
  2. Drag and drop a file or click to browse.
  3. Supported formats: .txt, .pdf, .docx
  4. The text will be extracted automatically.
  5. Click Generate Content.

Viewing Results

After generation, you'll see tabs for each platform:

Each platform includes:

Copying Content

Click the Copy button next to any section to copy it to your clipboard.

🔧 Troubleshooting

"Invalid or missing API key"

Your API key is not configured or is invalid. Go to Settings and enter a valid OpenRouter API key.

"Content is required"

You haven't entered any text or uploaded a file. Add some content before generating.

"Content exceeds maximum length"

Your input is too long. Try to reduce the content to under 5,000 words.

"API request failed with status 401"

Your API key is invalid or expired. Generate a new key at openrouter.ai/keys.

"API request failed with status 402"

Insufficient credits in your OpenRouter account. Add credits or switch to a free model.

"API request failed with status 429"

Rate limit exceeded. Wait a moment and try again.

"Connection error"

Network issue or server timeout. Check your internet connection and try again.

"Failed to parse AI response"

The AI returned an unexpected format. Try generating again or use a different model.

File Upload Errors

Ensure your file is a valid .txt, .pdf, or .docx file. Large or corrupted files may fail to process.

⚙️ System Requirements

Server Requirements

Browser Requirements

🔒 Security Information

⚠️ Important: Never share your API key publicly. If compromised, regenerate it immediately at openrouter.ai/keys.

← Back to Application