Install the Plugin

1. Download the Shop Writer plugin from your account
2. Go to WordPress Admin → Plugins → Add New → Upload Plugin
3. Upload the ZIP file and click Install Now
4. Click Activate Plugin

Enter Your License Key

1. Go to Shop Writer → Settings in your WordPress admin
2. Enter your license key in the License Key field
3. Check the Terms & Conditions agreement box
4. Click Validate License Now
5. Click Save Settings

Configure Settings

AI Model Selection

• GPT-3.5 Turbo: Faster and more cost-effective
• GPT-4 Turbo: Higher quality but uses more credits

Tone of Voice

• Professional: Formal, business-like tone
• Friendly: Warm and approachable
• Casual: Relaxed and conversational
• Enthusiastic: Energetic and exciting
• Technical: Detailed and specification-focused

Language Settings

• Source Language: The language of your existing product content
• Website Language: The target language for your store

Custom AI Instructions (Optional)

Write a custom prompt (up to 2,000 characters) to guide the AI for all content generation. You can also enable Field-Specific Instructions to give separate prompts for each content type.

Set Up Credit Alerts (Optional)

Configure notifications to monitor your credit usage:

• Warning Alert: 80% usage (recommended)
• Critical Alert: 90% usage
• Urgent Alert: 95% usage

Enable email alerts to receive notifications when thresholds are reached. You can set email recipients and notification frequency (once per alert level, daily, or weekly).

From Product Edit Page

1. Go to Products → All Products
2. Click Edit on any product
3. Look for the Shop Writer meta box (usually on the right side or below the editor)
4. Select which content fields you want to generate:
   • Product Title
   • Short Description
   • Product Description
   • Meta Title
   • Meta Description
   • Featured Image Alt Text
   • FAQ Section (3 Q&A) — uses 2 credits
5. Choose your operation type:
   • Generate: Create new content
   • Rewrite: Improve existing content
   • Translate: Convert to different language
6. Click Generate Content
7. Review the generated content in the preview tabs
8. Click Save Content to apply changes

From Product Data Tab (Classic Editor)

1. In the product edit page, scroll down to Product Data
2. Click the Shop Writer tab
3. Follow the same process as above
4. This method integrates directly with WooCommerce's interface

Access Bulk Generator

1. Go to Shop Writer → Bulk Content Generator
2. You'll see a 3-step process

Step 1: Select Products

Choose which products to process:

• All Products: Process your entire catalog
• By Categories: Select specific product categories
• By Attributes: Filter by product attributes (color, size, etc.)

Step 2: Configure Content Options

Select Content Fields

• Product Title
• Short Description (recommended)
• Product Description (recommended)
• Meta Title (recommended for SEO)
• Meta Description (recommended for SEO)
• Featured Image Alt Text
• All Product Images Alt Text (generates for every gallery image — 3 credits)
• FAQ Section (3 Q&A per product — 2 credits)

Smart Filtering Options

• Exclude Already Rewritten Products: Skip products already processed
• Only Products with Empty Content: Focus on products needing content

Advanced Options

• Continue on Failure: Don't stop if one product fails (recommended)
• Show Performance Metrics: Display real-time progress

Step 3: Review and Start

1. Click Calculate Credits to see:
   • Number of products selected
   • Credits required
   • Credits remaining
   • Sample products to be processed
2. Choose your approach:
   • Start Enhanced Bulk Update: Generate content directly
   • Preview Mode: Review content before applying (recommended for first-time users)

Generate Previews

1. Click Preview Mode after calculating credits
2. Wait for content generation (this may take several minutes)
3. Review generated content for each product
4. Use tabs to view different content types (Title, Description, FAQ, etc.)

Review and Edit

• Approve: Check the box for products you want to update
• Edit: Modify content directly in the preview
• Regenerate: Create new content for specific products

Apply Changes

1. Select all approved products
2. Click Apply Approved Changes
3. Wait for the updates to complete
4. Review the results in your WooCommerce products

Select Categories

• Every category is shown as a tile with its name, slug, parent, and product count
• Tiles show a preview of the existing description, or "No description" when empty — useful for quickly spotting categories that still need content
• Click individual tiles to toggle them, or use Select All Categories
• A live counter shows "X categories selected"

Fields to Generate

Pick any combination of:

• Category Description — the main description shown on the category archive page
• Meta Title (SEO) — the <title> tag for the category page
• Meta Description (SEO) — the search-result snippet

Operation Type

• Generate New Content: Create fresh content for the selected categories (best for empty categories)
• Rewrite Existing Content: Improve and rewrite current content while preserving category-specific context

Credit Calculation & Start

1. Click Calculate Credits to see Selected Categories, Credits Required, and Credits Remaining
2. Click Generate Descriptions to start
3. A live progress bar and results panel shows which categories completed, which failed, and the time spent

Enable the Feature

1. Go to Shop Writer → Interior Visualizer
2. Toggle the feature On
3. Configure settings:
   • Require Login: Require users to be logged in
   • Max Requests per IP: Daily limit per visitor (default: 10)
   • Max Image Size: Maximum upload size (default: 5 MB)
   • Cooldown: Seconds between generations (default: 30)
   • Image Quality: HD or Standard
   • Store Images: Save generated images on server
   • Storage Duration: How long to keep images (default: 7 days)
4. Optionally enable reCAPTCHA v3 for spam protection
5. Save settings

Enable for Individual Products

The visualizer can be enabled on a per-product basis:

1. Edit a product in Products → All Products
2. Find the AI Visualizer panel:
   • In Classic Editor: Look for the "AI Visualizer" tab in Product Data, or the "AI Visualizer" meta box in the sidebar
   • In Gutenberg / WPBakery: Look for the "AI Visualizer" meta box in the sidebar
3. Check Enable Visualizer
4. Optionally upload a Custom AI Image (transparent PNG recommended) to use instead of the featured image
5. Save the product

Add via Shortcode (Optional)

You can also add the visualizer to any page or post using the shortcode:

Shortcode Parameters

• title: Custom heading text
• description: Custom description text
• product_id: Pre-select a specific product
• show_gallery: Show gallery of previous generations ("yes" or "no")

Access Blog Generator

1. Go to Shop Writer → Blog Generator
2. Configure blog settings:
   • Enable Auto-Generation: Toggle automatic blog creation
   • Word Count: Set minimum and maximum word count (default: 300–800)
   • Posts per Week: How many posts to generate automatically
   • Auto-Publish: Publish immediately or save as draft
   • Internal Linking: Automatically link to products and categories
   • SEO Generation: Auto-populate Yoast SEO / Rank Math metadata

Create Blog Topics

Define topics that the AI will write about:

1. Click Add New Topic
2. Enter a topic title and description
3. Assign WordPress categories for the generated posts
4. Optionally add a custom AI prompt specific to this topic
5. Save the topic

Add Blog Images

Upload images to be used as featured images for generated posts:

• Upload multiple images to the blog image library
• Images are randomly selected for each new post
• Supports both uploaded and external image modes

Generate and Schedule

• Manual Generation: Click the generate button to create a post immediately
• Automatic Scheduling: Posts are generated via WordPress cron based on your "posts per week" setting
• Reschedule: Adjust the next generation time
• View statistics: total topics, generated posts, and next generation time

Step 1 — Upload

Provide the source file in one of two ways:

• Upload File: Drag and drop a CSV or XML file, or click Browse Files. Very large files are uploaded in chunks automatically.
• From URL: Paste a direct CSV / XML URL and click Fetch. Servers that support HTTP Range download in chunks; otherwise the file is streamed in a single request.

If indexing is already in progress from a previous visit, a blue "Indexing in progress" banner appears with a live row counter, a View live progress link, and a Cancel indexing button. You can safely close the tab — progress is preserved on the server and resumes from where it stopped.

Step 2 — Mapping

Once the file is indexed, map its columns / XML elements to WooCommerce product fields. The mapping screen has four sub-tabs:

• Field Mapping: Map columns to SKU, Product Name, Description, Regular Price, Sale Price, Stock Quantity, Categories, Image URL, Brand, Product Type, External URL, Buy Button Text, and more.
• Category Mapping: After mapping a column to "Categories", set how feed categories map to existing WooCommerce categories (or auto-create them).
• Attribute Mapping: Map extra columns (color, size, material, etc.) to WooCommerce product attributes.
• Settings: Configure Product Type (Simple or External/affiliate), Brand Storage (attribute or taxonomy), Image Handling (download to Media Library or use external images), Remove Missing Products, 301 Redirect target, and Fixed Category override.

Saved Mappings & Scheduled Imports

• Save Mapping: Save the current field / category / attribute mapping under a name to reuse it for future imports from the same supplier.
• Save as Scheduled Import: Persist the mapping together with the source URL so it can run automatically via cron.

Step 3 — Selection

Review a searchable, paginated preview of every product in the file. All products are selected by default — uncheck the ones you do not want to import.

• Search & Filter: Filter by any mapped field (brand, category, price range, etc.)
• Select All / Deselect All: Bulk toggle selections for the current filter
• The selection counter shows X selected of Y products in real time

Step 4 — Import

Start the import and watch live statistics update: Imported, Updated, Skipped, and Errors. Any errors are collected in an inline Error Log below the progress bar.

Import Options

• Update Existing Products: Update products with a matching SKU instead of skipping them
• Skip Existing Products: Leave matching-SKU products untouched
• Dry Run (Preview Only): Simulate the import without creating or modifying any product
• Run in Background: Process via WordPress cron — no need to keep the browser open
• Delete Source File: Remove the uploaded CSV / XML after the import completes
• Keep Index for Re-import: Retain the indexed SQLite database so you can re-import with different settings later

When the import finishes, action buttons appear: View Products, Re-import Same File, New Import, and Delete Import Files.

Open the Feed Editor

1. Go to Shop Writer → Feed Sync
2. Click Add New Feed
3. The feed editor opens as a modal with four tabs: General, Field Mapping, Categories, and Sync Settings

General Tab

• Feed Name: A label to identify this feed (e.g. "Supplier Product Feed")
• Source Type: Choose URL (HTTP / HTTPS) or FTP.
  • URL feeds accept any HTTP / HTTPS endpoint, with or without basic auth
  • FTP feeds accept host, port, username, password, and remote path
• Feed URL: The full path to the CSV or XML feed
• Test: Click the Test button to validate the URL and preview the first rows before saving

Field Mapping Tab

Map feed columns to WooCommerce product fields:

• SKU, Product Name, Description, Regular Price, Sale Price, Stock Quantity
• Categories, Image URL, Brand (with option to store as Attribute or product_brand taxonomy)
• Product Type, External Product URL, Buy Button Text (for affiliate feeds)

Categories Tab

Map feed category values to existing WooCommerce product categories. Unmapped categories can be auto-created, or the row can be skipped entirely — your choice.

Sync Settings Tab

Schedule

• Manual Only: Only run when you click Run Now
• Hourly, Every 6 Hours, Every 12 Hours, Daily, or Weekly

Fields to Update

Choose which fields are refreshed for existing products on each run: Price, Stock, Description, Name, Categories, Sale Price, Images, Brand, Short Description.

Image Handling

• Use external images (don't download): Link directly to feed image URLs instead of downloading into your Media Library — ideal for huge catalogs

Removal Policy

• Remove products not in feed: Products missing from the current feed are permanently deleted
• 301 Redirect Target: Choose a page (or Homepage) to redirect the removed product URLs to

Status

• Active: The feed runs on its schedule
• Paused: The feed is skipped until you re-activate it

For New Stores

1. Set up Shop Writer with GPT-3.5 Turbo
2. Generate content for all products using bulk operations
3. Review and refine content for your top 10–20 products using GPT-4
4. Generate category descriptions via Category Generator
5. Set up the Blog Generator with a few topics
6. Enable Interior Visualizer for your flagship products

For Existing Stores

1. Use "Only Products with Empty Content" filter
2. Generate missing meta titles and descriptions first
3. Use "Rewrite" operation to improve low-performing product pages
4. Focus on categories with poor SEO performance
5. Mark your best-written product as a Reference Product