DDF Seller User Guide

DDF Seller – User Guide

Multi-Platform E-Commerce Management System

Version: 2.2.0
Last Updated: February 21, 2026
For WordPress 5.0+

Table of Contents

  1. Introduction
  2. Installation & Setup
  3. Platform Configuration
  4. Creating Your First Listing
  5. Managing Your Inventory
  6. AI Features
  7. Advanced Features
  8. Troubleshooting
  9. Best Practices
  10. FAQ

1. Introduction

What is DDF Seller?

DDF Seller is a comprehensive WordPress plugin that allows you to manage product listings across 11 different online marketplaces from a single dashboard. Instead of manually creating the same listing on multiple platforms, you create it once in WordPress and distribute it with one click.

The Problem It Solves:

  • Manually posting the same item on Kijiji, Facebook, eBay, Etsy, etc. is time-consuming
  • Each platform has different forms, categories, and requirements
  • Tracking what’s posted where becomes a nightmare
  • Updating/deleting listings requires visiting each site individually

The Solution:

  • Single Source of Truth – One product entry in WordPress
  • One-Click Distribution – Click a button to post to any marketplace
  • AI Assistance – Automatically generate titles, descriptions, and categories from photos
  • Centralized Management – See all your listings across all platforms in one place
  • Browser Automation – Forms are filled automatically using Tampermonkey scripts

Key Features

🤖 AI-Powered Content Generation

  • Upload a photo and AI analyzes it
  • Generates optimized titles and descriptions
  • Suggests appropriate categories
  • Estimates fair market pricing
  • Supports GPT-4 Vision, Claude Sonnet, and Google Gemini

🚀 One-Click Posting

  • Browser automation fills marketplace forms automatically
  • No manual copy-pasting required
  • Progress popup shows what’s happening
  • Success handler updates WordPress database automatically

📊 Centralized Dashboard

  • View all items across all platforms
  • Filter by platform, status, or date
  • Quick actions: Edit, Delete, View listing
  • Bulk operations for multiple items

🔄 WooCommerce Integration

  • Sync with WooCommerce products
  • Bidirectional updates
  • DDF meta boxes in WooCommerce editor
  • Category synchronization

📱 Mobile-Friendly

  • Progressive Web App (PWA) support
  • Create listings from your phone camera
  • Responsive design for all screen sizes

🗺️ Smart Category Mapping

  • Each platform has different categories
  • DDF automatically translates between them
  • One category selection → all platforms mapped
  • Visual category mapper interface

Supported Platforms

Platform Status API Integration Browser Automation
Kijiji ✅ Active ❌ No ✅ Yes
Facebook Marketplace ✅ Active ❌ No ✅ Yes
eBay ✅ Active ✅ Yes ✅ Yes
Etsy ✅ Active ✅ Yes ✅ Yes
Poshmark ✅ Active ❌ No ✅ Yes
Shopify ✅ Active ✅ Yes ❌ No
Grailed 🚧 Beta ❌ No ✅ Yes
Mercari 🚧 Beta ❌ No ✅ Yes
Depop 🚧 Beta ❌ No ✅ Yes
Vinted 🚧 Beta ❌ No ✅ Yes
ThredUP 📝 Planned ❌ No ⏳ Pending

2. Installation & Setup

WordPress Installation

Prerequisites

  • WordPress 5.0 or higher
  • PHP 7.4 or higher
  • MySQL 5.6 or higher
  • WooCommerce (optional, for integration features)

Installation Steps

  1. Upload Plugin Files 
    Navigate to: WordPress Admin → Plugins → Add New → Upload Plugin
Select: ddf-seller.zip
Click: Install Now → Activate
  2. Verify Installation
    • You should see “DDF Seller” in the WordPress admin menu
    • Navigate to: DDF Seller → Dashboard
    • If you see the dashboard, installation was successful
  3. Database Setup
    • The plugin automatically creates required tables on activation
    • Tables created: wp_ddf_items, wp_ddf_poshmark_followed_users
    • To verify: DDF Seller → Settings → Database

Browser Extension Setup

DDF uses Tampermonkey to automate marketplace forms. You only need to install ONE script.

Step 1: Install Tampermonkey

Chrome/Edge:

  1. Visit Chrome Web Store
  2. Search for “Tampermonkey”
  3. Click “Add to Chrome” → “Add Extension”

Firefox:

  1. Visit Firefox Add-ons
  2. Search for “Tampermonkey”
  3. Click “Add to Firefox” → “Add”

Step 2: Install DDF Loader Script

  1. Navigate to: DDF Seller → Settings → General
  2. Scroll to: Browser Automation
  3. Click: Install Automation Script
  4. Tampermonkey will open asking to install
  5. Click: Install

That’s it! The loader script automatically loads platform-specific cores from your WordPress server.

How It Works

WordPress Button Click
  ↓
Opens marketplace URL with product data
  ↓
Tampermonkey Loader detects platform
  ↓
Requests platform-specific core from WordPress
  ↓
Core fills form and shows progress popup
  ↓
Success handler updates WordPress database

Benefits:

  • ✅ Install once, never update manually
  • ✅ Updates happen server-side automatically
  • ✅ Testing changes requires no cache clearing
  • ✅ No need to manage multiple scripts

Initial Configuration

Step 1: Configure Active Platforms

  1. Navigate to: DDF Seller → Settings → General
  2. Under Active Platforms, check the marketplaces you use
  3. Drag to reorder (affects button display order)
  4. Click: Save Settings

Step 2: Set Default Location

Most marketplaces require a location. Set defaults to speed up listing creation:

  1. Navigate to: DDF Seller → Settings → General
  2. Under Default Location:
    • Country: Canada or United States
    • Province/State: Your province/state
    • City: Your city
    • Postal Code: Your postal code
  3. Click: Save Settings

Step 3: Configure AI (Optional)

If you want AI assistance for generating content:

  1. Navigate to: DDF Seller → Settings → AI
  2. Choose AI Engine:
    • OpenAI GPT-4 Vision (recommended for accuracy)
    • Google Gemini (free tier available)
    • Anthropic Claude Sonnet (best for detailed descriptions)
  3. Enter API Key (get from respective provider)
  4. Enable: Auto-analyze images on upload
  5. Click: Save Settings

Where to get API keys:

  • OpenAI: https://platform.openai.com/api-keys
  • Google: https://makersuite.google.com/app/apikey
  • Anthropic: https://console.anthropic.com/

3. Platform Configuration

Each marketplace requires specific credentials and settings. This section covers how to configure each platform.

Account Credentials

IMPORTANT: Account Credentials should be the first entry on every platform’s settings page. This is the information you use to log into your account on that marketplace.

Standard Fields:

  • Login Email/Username – Your account login (usually email)
  • Password – Your account password
  • Shop URL – Your store/profile URL on the platform

Why we need this:

  • Browser automation requires login credentials
  • Some platforms need shop URLs for API calls
  • Ensures automation accesses the correct account

Kijiji Setup

  1. Navigate to: DDF Seller → Settings → Kijiji
  2. Account Credentials:
    • Username: Your Kijiji login email
    • Password: Your Kijiji password
    • Profile URL: https://www.kijiji.ca/o-profile/XXXXXX
  3. Fulfillment Options:
    • ☑️ Delivery available
    • ☑️ Shipping available
    • ☑️ Curbside pickup
  4. Payment Options:
    • ☑️ Cashless payment accepted
    • ☑️ Cash accepted
  5. Ad Tracking:
    • Ad Lifespan 1: 30 days (Top Ads paid)
    • Ad Lifespan 2: 60 days (Regular ads)
  6. Publication Settings:
    • ☑️ Append identifier to description
    • Identifier Type: My Item ID
    • ☑️ Set minimum price: $10
  7. Click: Save Kijiji Settings

Facebook Marketplace Setup

  1. Navigate to: DDF Seller → Settings → Facebook
  2. Account Credentials:
    • Username: Your Facebook email
    • Password: Your Facebook password
    • Shop URL: https://www.facebook.com/marketplace/profile/@YOUR_USERNAME
  3. Meetup Preferences:
    • ☑️ Public meetup (coffee shops, malls)
    • ☑️ Door pickup (buyer comes to you)
    • ☑️ Door dropoff (you deliver)
  4. Messenger Automation:
    • ☑️ Enable auto-response
    • Response delay: 30 seconds
    • Auto-message: “Hi! Thanks for your interest. Is the item still available? Yes!”
  5. Ad Tracking:
    • Ad Lifespan 1: 7 days
    • Ad Lifespan 2: 30 days
  6. Click: Save Facebook Settings

eBay Setup

eBay uses OAuth authentication – more complex but more secure.

  1. Navigate to: DDF Seller → Settings → eBay
  2. Developer Account Setup:
    • Visit: https://developer.ebay.com/
    • Create a developer account
    • Create a “Production” application
    • Note down: App ID, Client ID, Client Secret, RuName
  3. API Credentials:
    • App Name: Your app name from eBay
    • Client ID: From eBay developer console
    • Client Secret: From eBay developer console
    • RuName: Redirect URL name from eBay
    • Domain: ebay.com (or ebay.ca)
  4. OAuth Connection:
    • Click: Connect to eBay
    • Login to eBay and authorize the app
    • You’ll be redirected back with “OAuth successful!” message
  5. Business Policies:
    • Fulfillment Policy ID: Your eBay shipping policy ID
    • Payment Policy ID: Your eBay payment policy ID
    • Return Policy ID: Your eBay return policy ID

    (Get these from eBay Seller Hub → Business Policies)

  6. Listing Preferences:
    • ☑️ Local pickup available
    • ☐ Sandbox mode (for testing only)
  7. Click: Save eBay Settings

Test Connection:

  • Click: Test eBay Connection
  • Should show: “✅ Connection successful! Token valid.”

Etsy Setup

Etsy uses OAuth v2 for API access.

  1. Navigate to: DDF Seller → Settings → Etsy
  2. Developer App Setup:
    • Visit: https://www.etsy.com/developers/your-apps
    • Create a new app
    • Note: API Key (Client ID)
  3. API Credentials:
    • Client ID: From Etsy developer portal
    • Client Secret: From Etsy developer portal
  4. OAuth Connection:
    • Click: Connect to Etsy
    • Login to Etsy and authorize
    • Grant permissions for shop access
    • Redirects back with success message
  5. Core Listing Details (Defaults):
    • Who Made It: Someone else
    • What Is It: Finished product
    • When Made: 2020-2026
    • Item Type: Physical
    • Renewal: Automatic
  6. Publication Settings:
    • ☑️ Append identifier
    • Identifier Type: My Item ID
  7. Click: Save Etsy Settings

Poshmark Setup

Poshmark doesn’t have an API, so we use browser automation + database tracking.

  1. Navigate to: DDF Seller → Settings → Poshmark
  2. Account Details:
    • Your Closet URL: https://poshmark.ca/closet/YOUR_USERNAME
    • Login Email: Your Poshmark login email
    • Login Password: Your Poshmark password

    ✅ System will automatically extract username from closet URL

  3. Poshmark Configuration:
    • Default Closet: “All” or specific category
    • ☐ Auto-publish new listings (manual posting recommended)
  4. Automation Settings:

    Navigate to: DDF Seller → Main → Poshmark Tab

    • Mode: Follow + Share (default)
    • Items to share per user: 2
    • Max users per session: 500
  5. Launch Automation:
    • Click: 🚀 Launch Followers (CA) or (US)
    • Browser opens to your followers page
    • Automation follows new followers and shares their items
    • Database tracks who you’ve followed (prevents duplicates)
  6. Click: Save Poshmark Settings

Poshmark Automation Features:

  • Follow-back automation – Auto-follows users who follow you
  • Share automation – Shares items from followed users
  • Database tracking – Never follows same user twice
  • Country detection – Tracks CA vs US separately
  • Stats dashboard – See total followed, accessed today, etc.

Shopify Setup

Shopify uses OAuth for store integration.

  1. Navigate to: DDF Seller → Settings → Shopify
  2. Shop Settings:
    • Shop URL: your-store.myshopify.com
    • Username: Admin email (for reference)
    • Password: Not used (OAuth handles auth)
  3. OAuth Connection:
    • Click: Connect to Shopify
    • Login to your Shopify store
    • Click: Install App
    • Grant permissions
    • Redirects back with success
  4. Publication Settings:
    • ☑️ Append identifier
    • Identifier Type: WooCommerce SKU
    • ☑️ Set minimum price: $15
  5. Click: Save Shopify Settings

Note: Shopify integration allows:

  • Creating products via API
  • Updating inventory
  • Managing product images
  • Collections assignment

Other Platforms

Grailed, Mercari, Depop, Vinted, ThredUP:

These platforms currently use browser automation only (no API integration).

  1. Navigate to: DDF Seller → Settings → [Platform]
  2. Account Credentials:
    • Username: Your login email
    • Password: Your password
    • Shop URL: Your profile URL
  3. Publication Settings:
    • Configure identifier appending
    • Set minimum price if desired
  4. Click: Save [Platform] Settings

4. Creating Your First Listing

Manual Entry

  1. Navigate to: DDF Seller → Add New
  2. Product Information:
    • Title: Clear, descriptive title (max 80 chars)
    • Description: Detailed description with:
      • Brand/make
      • Condition
      • Size/dimensions
      • Materials
      • Defects/wear
      • Shipping details
    • Price: List price in CAD/USD
    • Quantity: Number available
  3. Categories:
    • Level 1: Broad category (e.g., “Clothing”)
    • Level 2: Sub-category (e.g., “Women’s Clothing”)
    • Level 3: Specific type (e.g., “Dresses”)

    System automatically maps to all platforms

  4. Condition:
    • New with tags
    • New without tags
    • Like new
    • Gently used
    • Well worn
    • Not specified
  5. Images:
    • Click: Upload Images
    • Select up to 10 photos
    • Drag to reorder (first image is primary)
    • Images are optimized automatically
  6. Location:
    • Country, Province, City, Postal Code
    • Pre-filled from default settings
  7. Click: Save Item

AI-Assisted Creation

Let AI analyze your photos and generate content automatically.

  1. Navigate to: DDF Seller → Add New
  2. Upload Images First:
    • Click: Upload Images
    • Select product photo(s)
    • Wait for upload to complete
  3. AI Analysis:
    • Click: 🤖 Analyze with AI
    • Progress indicator shows:
      • Uploading image to AI…
      • Analyzing image…
      • Generating content…
    • Results appear in ~10-15 seconds
  4. AI Provides:
    • Title: SEO-optimized product title
    • Description: Detailed description with:
      • Brand identification
      • Condition assessment
      • Material/fabric detection
      • Size estimation
      • Style/era classification
    • Category Suggestions: Top 3 best-fit categories
    • Price Estimate: Fair market value range
  5. Review and Edit:
    • AI suggestions appear as editable text
    • Make any adjustments needed
    • Select best category from suggestions
  6. Click: Save Item

AI Tips:

  • ✅ Use clear, well-lit photos
  • ✅ Include close-ups of tags/labels
  • ✅ Show defects/wear clearly
  • ❌ Avoid blurry or dark photos
  • ❌ Don’t use heavily filtered images

Posting to Marketplaces

Once your item is created, posting to marketplaces is one click.

Method 1: From Edit Page

  1. Navigate to: DDF Seller → Items → Edit [Item]
  2. Scroll to: Post to Marketplaces
  3. Platform buttons appear:
    • 📘 Facebook
    • 🅺 Kijiji
    • 🛍️ eBay
    • 🎨 Etsy
    • 👗 Poshmark
    • 🛒 Shopify
    • etc.
  4. Click any platform button:
    • New browser tab opens
    • Tampermonkey loads
    • Progress popup shows:
      • ⏳ Loading product data…
      • ✍️ Filling title…
      • ✍️ Filling description…
      • 📸 Uploading images…
      • 🗂️ Selecting category…
      • ✅ Complete!
    • Form is filled automatically
  5. Review and Submit:
    • Check auto-filled fields
    • Make platform-specific adjustments
    • Click platform’s “Post” or “List” button
    • Success handler updates WordPress automatically
  6. Return to WordPress:
    • Item status updates to “Posted”
    • Platform icon shows ✅
    • Listing URL is saved

Method 2: Bulk Posting

Post multiple items to same platform simultaneously:

  1. Navigate to: DDF Seller → Items
  2. Check boxes next to items you want to post
  3. Select: Bulk Actions → Post to [Platform]
  4. Click: Apply
  5. Multiple browser tabs open (one per item)
  6. Each tab processes automatically

Note: Limit to 5-10 items at once to avoid overwhelming your browser.

5. Managing Your Inventory

The Main Dashboard

Navigate to: DDF Seller → Dashboard

Overview Cards:

  • Total Items: All items in system
  • Posted Items: Items live on at least one platform
  • Draft Items: Items not yet posted
  • Recent Activity: Last 10 actions

Platform Statistics:

  • Shows count per platform
  • Click platform name to filter items
  • Color-coded status indicators

Quick Actions:

  • Add New Item
  • View All Items
  • Export Data
  • Settings

Viewing Items

Navigate to: DDF Seller → Items

List View Shows:

  • Thumbnail image
  • Title
  • Price
  • Status (Posted / Draft / Expired)
  • Platform icons (✅ posted, ⏳ pending, ❌ errors)
  • Posted date
  • Actions (Edit | Delete | View)

Filters:

  • Platform: Show only items on specific platform
  • Status: Posted, Draft, Expired
  • Date Range: Last 7 days, 30 days, All time
  • Search: Text search in title/description

Sorting:

  • Title (A-Z)
  • Price (Low-High / High-Low)
  • Date (Newest / Oldest)
  • Status

Editing Items

  1. Click: Edit next to any item
  2. Edit Form Shows:
    • All product information (editable)
    • Current platform status
    • Posting buttons for each platform
    • Update timestamp
  3. Make Changes:
    • Edit title, description, price, etc.
    • Upload/remove images
    • Change categories
  4. Click: Update Item

Platform Updates:

  • API-enabled platforms (eBay, Etsy, Shopify):
    • Changes sync automatically
    • Click: Update on [Platform]
    • Remote listing updates instantly
  • Browser automation only (Kijiji, Facebook, Poshmark):
    • Must edit listing manually on platform
    • Or delete and repost with new information

Bulk Operations

Select multiple items and apply actions:

  1. Navigate to: DDF Seller → Items
  2. Check boxes next to items
  3. Bulk Actions:
    • Post to Platform – Post all selected to one platform
    • Delete – Permanently remove items
    • Mark as Sold – Update status
    • Export Selected – Download as Excel/PDF
    • Change Category – Bulk recategorize
  4. Click: Apply

Bulk Export:

  • Exports selected items to Excel
  • Includes all details, images URLs, platform status
  • Great for backup or external analysis

6. AI Features

Image Analysis

AI analyzes your product photos to extract information.

What AI Detects:

  • Brand/Make: Logo detection, text recognition
  • Condition: Visual assessment of wear, defects
  • Materials: Fabric type, leather, metal, plastic
  • Colors: Primary and secondary colors
  • Size: If visible on tags/labels
  • Style: Vintage, modern, casual, formal
  • Era: Decade of manufacture (for vintage items)

How to Use:

  1. Upload clear, well-lit photo
  2. Click: 🤖 Analyze with AI
  3. Wait 10-15 seconds
  4. Review suggestions
  5. Accept or edit

Best Results:

  • ✅ Natural lighting
  • ✅ Clean background
  • ✅ Include size tags/labels
  • ✅ Show logos clearly
  • ✅ Capture defects/wear

Auto-Categorization

AI suggests the best category for your item across all platforms.

How It Works:

  1. Analyzes product image and title
  2. Matches against category database
  3. Provides top 3 suggestions with confidence scores

Example:

Product: Photo of vintage leather jacket

AI Suggestions:
1. Clothing → Men's Clothing → Jackets & Coats (95%)
2. Clothing → Unisex Adult Clothing → Outerwear (87%)
3. Vintage → Men's Vintage → Jackets (82%)

Platform Translation:

  • You select: “Clothing → Men’s → Jackets”
  • DDF maps to:
    • Kijiji: “Clothing & Accessories → Men → Jackets & Coats”
    • eBay: “Clothing, Shoes & Accessories → Men → Men’s Clothing → Coats & Jackets”
    • Poshmark: “Men → Jackets & Coats → Bomber & Varsity”
    • Etsy: “Clothing → Men’s Clothing → Jackets & Coats”

Content Generation

Title Generation:

  • SEO-optimized
  • Includes brand, size, color, condition
  • Platform character limits respected
  • Format: [Brand] [Type] [Size] [Color] [Condition]

Example:

Levi's 501 Jeans Mens 32x34 Dark Blue Vintage 90s Excellent

Description Generation:

  • Detailed product description
  • Structured format:
    • Overview
    • Condition assessment
    • Measurements (if visible)
    • Material/fabric details
    • Notable features
    • Defects/wear (honest disclosure)

Price Estimation:

  • Based on:
    • Brand recognition
    • Condition assessment
    • Market data (if available)
    • Comparative listings
  • Provides range: Low – Mid – High
  • Consider as starting point, adjust based on your market knowledge

7. Advanced Features

Category Mapping

Each platform uses different category structures. DDF translates between them.

Accessing Category Mapper:

  1. Navigate to: DDF Seller → Settings → [Platform]
  2. Expand: 📂 Category Mapping
  3. Click: 🗺️ Load Category Mapping

Interface Shows:

  • Left column: WooCommerce categories
  • Right column: Platform-specific categories
  • Dropdown for each mapping
  • Save/Update buttons

Best Practices:

  1. Map broad categories first:
    • Clothing → Clothing & Accessories
    • Electronics → Electronics & Computers
    • Home → Home & Garden
  2. Get specific:
    • Women’s Dresses → Women’s Clothing → Dresses
    • Men’s Watches → Jewelry & Watches → Watches → Men’s
  3. Test mappings:
    • Create test item
    • Check auto-selected category
    • Adjust if incorrect
  4. Update regularly:
    • Platforms add new categories
    • Click: Update Unsynced to refresh

Auto-Sync Features:

  • Initial Sync: Maps categories by name matching
  • Update Unsynced: Adds new WooCommerce categories to mapping
  • Preserve Existing: Keeps your manual mappings intact

WooCommerce Integration

If you use WooCommerce, DDF integrates seamlessly.

Setup:

  1. Install WooCommerce plugin
  2. Navigate to: DDF Seller → Settings → WooCommerce
  3. Enable: ☑️ Auto-create WooCommerce products
  4. Default Status: Draft or Publish
  5. Save settings

How It Works:

DDF → WooCommerce:

  • Create item in DDF
  • WooCommerce product auto-created
  • Links stored bidirectionally
  • Categories sync

WooCommerce → DDF:

  • Edit WooCommerce product
  • DDF item updates automatically
  • Price, title, description sync
  • Images sync

Meta Boxes:

  • DDF adds custom fields to WooCommerce product editor
  • Shows platform posting status
  • Quick-post buttons
  • View marketplace links

Product Gallery:

  • DDF images → WooCommerce gallery
  • Primary image → Featured image
  • All images available in product page

Export Functions

Export your inventory data for backup or analysis.

Export Formats:

  • Excel (.xlsx) – Full data with images
  • CSV – Text-based, import-friendly
  • PDF – Printable inventory report

Export Options:

  1. Navigate to: DDF Seller → Export
  2. Select:
    • All Items or Selected Items
    • Date Range (optional)
    • Platform Filter (optional)
  3. Choose Format: Excel, CSV, or PDF
  4. Click: Generate Export
  5. Download file

Excel Export Includes:

  • Item ID
  • Title
  • Description
  • Price
  • Quantity
  • Condition
  • Categories (L1, L2, L3)
  • Image URLs
  • Platform status (Posted/Draft)
  • Posted URLs for each platform
  • Created/Updated dates

Use Cases:

  • Backup inventory data
  • Import to other systems
  • Accountancy/tax records
  • Market analysis
  • Offline price list

Automation Scripts

Poshmark Share-Back Automation:

Navigate to: DDF Seller → Main → Poshmark

Features:

  • Auto-follows users who follow you
  • Shares items from followed users
  • Tracks followed users in database
  • Prevents duplicate follows
  • Country-aware (CA vs US)

Settings:

  • Mode:
    • Both (Follow + Share)
    • Follow Only
    • Share Only
    • New Only (skip already-followed users)
  • Items per User: How many items to share (0-10)
  • Max Users per Session: Rate limit (1-1000)

Launch:

  1. Set your Closet URL in settings
  2. Choose mode and limits
  3. Click: 🚀 Launch Followers (CA/US)
  4. Browser opens to followers page
  5. Script runs automatically
  6. Database updates in real-time

Stats:

  • Total followed
  • CA vs US breakdown
  • Accessed today count

Kijiji Auto-Scraper:

Navigate to: DDF Seller → Settings → Kijiji

Features:

  • Scrapes your posted ads from profile
  • Updates ad status (Active/Expired)
  • Adds ad URLs to database
  • Runs on schedule

Setup:

  1. Enter Profile URL
  2. Enable: ☑️ Auto-scrape profile
  3. Scrape Frequency: Every 60 minutes
  4. Save settings

How It Works:

  • WordPress cron job runs hourly
  • Fetches your Kijiji profile page
  • Parses ad listings
  • Updates database
  • Shows expired ads for renewal

8. Troubleshooting

Common Issues

Items Not Saving

Symptoms: Click “Save Item” but nothing happens

Solutions:

  1. Check JavaScript console (F12) for errors
  2. Verify all required fields filled
  3. Check if images oversized (>5MB limit)
  4. Disable conflicting plugins
  5. Clear browser cache

Images Not Uploading

Symptoms: Upload spinner hangs, images don’t appear

Solutions:

  1. Check file format (JPG, PNG only)
  2. Verify file size (<5MB per image)
  3. Check WordPress upload limits:
    • php.ini: upload_max_filesize
    • post_max_size
  4. Check server disk space
  5. Ensure wp-content/uploads/ddf/ is writable

Category Mapping Not Working

Symptoms: Wrong categories selected on platforms

Solutions:

  1. Navigate to: Settings → [Platform] → Category Mapping
  2. Click: Load Category Mapping
  3. Verify mappings are correct
  4. Click: Update Unsynced to refresh
  5. Test with new item

Browser Automation Not Working

Tampermonkey Script Not Loading

Symptoms: Click platform button, form doesn’t auto-fill

Solutions:

  1. Verify Installation:
    • Click Tampermonkey icon
    • Should show “DDF Loader” enabled
    • Green checkmark indicates active
  2. Check URL Pattern:
    • Tampermonkey only runs on matching URLs
    • Must be on actual marketplace site
    • Check @match patterns in script
  3. Clear Cache:
    • Tampermonkey dashboard
    • Find DDF Loader
    • Click: Edit
    • Click: File → Reinstall
  4. Check Console:
    • F12 → Console tab
    • Look for DDF loader messages
    • Report errors to support

Form Not Filling Correctly

Symptoms: Some fields empty, wrong data

Solutions:

  1. Platform UI Changed:
    • Marketplaces update their forms
    • WordPress needs updated core
    • Check for core updates: Settings → System
  2. Product Data Missing:
    • Verify item has all required fields
    • Check image uploads completed
    • Ensure categories selected
  3. Wrong Platform Core:
    • Clear browser cache
    • Force reload (Ctrl+Shift+R)
    • Check WordPress serving correct core

Success Handler Not Updating

Symptoms: Form filled/posted but WordPress shows “Draft”

Solutions:

  1. CORS/Security:
    • Check browser console for CORS errors
    • Verify WordPress accessible from marketplace domain
    • Check if HTTPS required
  2. Database Connection:
    • Test: DDF Seller → Settings → Database → Test Connection
    • If failed, check database credentials
  3. AJAX Error:
    • F12 → Network tab
    • Find admin-ajax.php request
    • Check response for errors

Database Errors

MySQL Connection Failed

Symptoms: “Database connection error” on dashboard

Solutions:

  1. Check wp-config.php credentials
  2. Verify MySQL service running
  3. Check database user permissions
  4. Test connection from command line: 
    mysql -u username -p database_name

Tables Missing

Symptoms: “Table wp_ddf_items doesn’t exist”

Solutions:

  1. Navigate to: DDF Seller → Settings → Database
  2. Click: Reinstall Database Tables
  3. If fails, check error log
  4. Manual SQL import: docs/database-schema.sql

Slow Queries

Symptoms: Dashboard/item list loads very slowly

Solutions:

  1. Navigate to: Settings → Database
  2. Check: Optimize Tables
  3. Review slow query log
  4. Add indexes if needed
  5. Consider database cleanup:
    • Enable auto-cleanup
    • Set retention: 90 days

9. Best Practices

Photography

Lighting:

  • ✅ Natural daylight preferred
  • ✅ Soft, diffused light
  • ❌ Harsh shadows
  • ❌ Direct flash

Background:

  • ✅ Plain white or neutral
  • ✅ Clean, uncluttered
  • ❌ Busy patterns
  • ❌ Messy surroundings

Angles:

  • ✅ Front, back, sides
  • ✅ Close-ups of details
  • ✅ Tags/labels clearly visible
  • ✅ Show defects honestly

Editing:

  • ✅ Crop to focus on item
  • ✅ Adjust brightness slightly
  • ❌ Heavy filters
  • ❌ Misrepresent colors

Pricing Strategy

Research:

  1. Check sold listings on platform
  2. Compare similar items
  3. Consider condition honestly
  4. Factor in competition

Price Points:

  • New with tags: 50-70% retail
  • Like new: 40-60% retail
  • Gently used: 30-50% retail
  • Well worn: 20-30% retail

Negotiation Buffer:

  • List 10-15% above lowest acceptable
  • Allows room for offers
  • Buyers expect to negotiate

Platform Differences:

  • Poshmark: Lower prices, high volume
  • Etsy: Premium pricing for quality
  • Kijiji/Facebook: Expect haggling
  • eBay: Auction vs Buy Now strategy

Title Optimization

Formula:

[Brand] [Type] [Key Feature] [Size] [Color] [Condition]

Examples:

  • ✅ “Levi’s 501 Jeans Men’s 32×34 Dark Wash Vintage 90s”
  • ✅ “Nike Air Max 2021 Women’s Size 8 White/Pink New”
  • ❌ “Great jeans for sale!!!”
  • ❌ “Shoes”

Keywords:

  • Include searchable terms
  • Brand name first (if recognized)
  • Size/measurements essential
  • Condition builds trust

Character Limits:

  • Kijiji: 64 chars
  • eBay: 80 chars
  • Etsy: 140 chars
  • Poshmark: 50 chars
  • Facebook: 100 chars

Description Best Practices

Structure:

  1. Opening: Brief overview
  2. Details: Specs, measurements
  3. Condition: Honest assessment
  4. Shipping: Policies, timeline
  5. Call-to-Action: Encourage purchase

Example:

Vintage Levi's 501 jeans in excellent condition. 
Classic 90's dark wash with button fly.

Measurements:
- Waist: 32"
- Inseam: 34"
- Rise: 11"
- Leg Opening: 8"

Condition: Gently used, no rips or stains. 
Minor fading on thighs (see photos). Original 
leather patch intact.

Shipping: Ships within 1 business day via 
Canada Post. Carefully packaged.

Questions welcome! Reasonable offers considered.

Keywords for SEO:

  • Repeat brand/model
  • Include alternate names
  • Style descriptors
  • Era/decade
  • Materials/fabrics

Multi-Platform Strategy

Prioritize by Volume:

  1. Kijiji/Facebook: High traffic, local sales
  2. Poshmark: Fashion-focused buyers
  3. eBay: Collectors, specific items
  4. Etsy: Vintage, handmade, unique

Avoid:

  • Cross-posting identical item everywhere
  • Racing to bottom on price
  • Neglecting platform-specific optimization

Adjust by Platform:

  • Price: Higher on Etsy, lower on Poshmark
  • Photos: More artistic for Etsy, clear for Kijiji
  • Description: Detailed for eBay, concise for Facebook

Maintenance Routine

Daily:

  • Check for new messages/offers
  • Respond to inquiries promptly
  • Renew/bump top listings

Weekly:

  • Review expired listings
  • Update prices on stale items
  • Add new inventory
  • Check sold items, update in DDF

Monthly:

  • Category mapping review
  • Price adjustments based on market
  • Database cleanup (old drafts)
  • Export backup

Quarterly:

  • Review platform performance
  • Adjust posting strategy
  • Update templates
  • AI model evaluation

10. FAQ

Q: Do I need to pay for each platform?
A: DDF itself is free (self-hosted WordPress plugin). Individual platforms may have fees:

  • Kijiji: Free (paid “Top Ad” optional)
  • Facebook: Free
  • eBay: Insertion fees + final value fees
  • Etsy: $0.20 listing fee + 6.5% transaction
  • Poshmark: 20% commission on sales
  • Shopify: Monthly subscription ($39+)

Q: Can I use DDF without WooCommerce?
A: Yes! WooCommerce integration is optional. DDF works standalone.

Q: How many images can I upload per item?
A: 10 images maximum. Some platforms limit display (e.g., Kijiji shows up to 10, Facebook up to 10).

Q: What if a platform changes their form?
A: Browser automation may break. We push updates to platform cores automatically. Your Tampermonkey loader fetches the latest version from WordPress server.

Q: Can I edit a posted listing?
A: Depends on platform:

  • eBay/Etsy/Shopify: Yes, via API update
  • Kijiji/Facebook/Poshmark: Must edit manually on platform, then update DDF record

Q: Is my data backed up?
A: DDF stores in WordPress database. Use your existing WordPress backup solution. Additionally, export to Excel regularly.

Q: Can I use AI without paying?
A: Google Gemini has a free tier. OpenAI and Anthropic require paid API keys.

Q: What’s the difference between “my_item_id” and “wc_sku”?
A:

  • my_item_id: DDF’s internal unique ID (auto-generated)
  • wc_sku: WooCommerce SKU (must set manually)

Use my_item_id unless you manage inventory via WooCommerce SKUs.

Q: How do I delete an item from all platforms?
A: Delete from DDF only removes WordPress record. Must manually remove from each marketplace. API-enabled platforms (eBay/Etsy/Shopify) can delete remotely.

Q: Can I schedule listings to post later?
A: Not currently. Workaround: Save as Draft, manually post when ready.

Q: Why isn’t Poshmark API-integrated?
A: Poshmark doesn’t offer a public API. We use browser automation + database tracking instead.

Q: Can multiple users manage the same DDF installation?
A: Yes, WordPress has user roles. Assign “Editor” or custom role permissions.

Q: What happens if my WordPress goes down during automation?
A: Browser automation completes independently. Success handler will fail to update WordPress, but you can manually update platform status later.

Q: Can I customize the automation scripts?
A: Yes! Platform cores are JavaScript files in autofill/cores/. Edit with caution – may break automation.

Q: How do I report bugs or request features?
A: Contact via GitHub issues or email support@yourdomain.com

Need Help?

Documentation:

  • Project Manifest: docs/PROJECT_MANIFEST.md
  • Architecture: docs/ARCHITECTURE.md
  • Development Guide: docs/DEVELOPMENT_WORKFLOW.md

Support:

  • GitHub: https://github.com/yourrepo/ddf-seller
  • Email: support@yourdomain.com
  • Forum: https://forum.yourdomain.com

Updates:

  • Check: DDF Seller → Settings → System
  • Subscribe to update notifications
  • GitHub watch for new releases

Last Updated: February 21, 2026
Version: 2.2.0
License: Proprietary

End of User Guide