Configuration
Configure AI providers, context limits, and batch settings for the eBook Product Assistant.
Accessing Settings
To configure the plugin, navigate to WooCommerce > eBook Assistant and click on the Settings tab.
AI Configuration
The plugin relies on an external AI provider to summarize the extracted PDF text and generate product drafts. You must configure these settings before processing any files.
| Setting | Description |
|---|---|
| AI provider | Choose between OpenAI (default), Claude (Anthropic), or OpenRouter. |
| API key | Enter the API key for your chosen provider. This is stored securely in your WordPress database. |
| Model name | Specify the exact model ID to use (e.g., gpt-4o, claude-3-5-sonnet-20241022, or anthropic/claude-3.5-sonnet). |
| Max PDF characters for AI | Limits the amount of text sent to the AI model (default 25,000, max 50,000). This helps control API costs and prevents exceeding token limits. |
| Max PDF upload size (MB) | Limits the file size for PDF uploads (default 32 MB, max 100 MB). |
| Debug logging | When enabled, logs plugin lifecycle events to the PHP error log. API keys and full PDF text are never logged. |
After entering your API key and model name, click Save settings, then click the Test AI Connection button to verify that the plugin can successfully communicate with your provider.
Product Defaults
These settings control the default state of checkboxes on the product review form.
| Setting | Description |
|---|---|
| Downloadable by default | When enabled, the "Attach PDF as downloadable file" and "Make product downloadable" options are pre-checked on the review screen after a PDF is analyzed. |
Store Context for AI
To provide accurate suggestions for pricing, categories, and tags, the plugin loads a sample of your existing WooCommerce catalog into the AI prompt.
| Setting | Description |
|---|---|
| Products loaded for AI | Maximum published simple products to sample (default 50, max 200). When categories match the PDF, products are loaded from those categories only; otherwise, recent store-wide products are used. |
| Categories loaded for AI | Maximum product categories to load (default 100, max 500). Categories beyond this limit are omitted from AI prompts and the review form picker. |
| Tags loaded for AI | Maximum product tags to load (default 50, max 200). Tags beyond this limit are omitted from AI suggestions. |
Higher limits improve AI suggestions but increase the prompt size and API costs. If your store exceeds these limits, a warning notice will appear at the top of the settings page.
Batch Limits
These settings enforce safety rails when processing multiple PDFs simultaneously.
| Setting | Description |
|---|---|
| Max batch files | Maximum number of PDFs allowed in a single batch upload (default 25, max 100). |
| Max batch total size (MB) | Maximum combined file size for a batch upload (default 250 MB, max 1000 MB). |
| Max estimated AI cost (USD) | If the estimated API cost for a batch exceeds this amount, the plugin requires explicit confirmation before processing begins (default $20.00). |
| Estimated cost per 1M tokens (USD) | Used to calculate the approximate batch cost range before processing (default $5.00). Adjust this based on your chosen AI provider's pricing. |