First Setup

Configure the initial settings to fit your customization workspace and brand specifications for both the WordPress plugin and Laravel licensing portal.

BallinKit Plugin Settings

Head to KIT Designer > Settings to configure global presets:

General Settings

API URL: Your licensing portal URL (e.g., https://your-domain.com)
API Secret: Shared secret for HMAC signature verification (must match portal)
Cache Directory: Custom path for preview cache (default: wp-content/cache/kit/)
Upload Directory: Custom path for user uploads (default: wp-content/uploads/kit-uploads/)

Pricing Settings

Per-Text Surcharge: Additional charge per text layer
Per-Upload Surcharge: Additional charge per uploaded image
Per-View Surcharge: Additional charge per active view

BallingKit License Portal Settings

Configure your Laravel application via the .env file:

Application Settings

APP_NAME="Kit Licencing"
APP_ENV=production
APP_URL=https://your-domain.com
APP_DEBUG=false

Database Settings

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=kit_licencing
DB_USERNAME=your_username
DB_PASSWORD=your_password

API Security Settings

KIT_API_SECRET=kit_secure_api_handshake_secret_2026
KIT_DECRYPTION_KEY=your_decryption_key
CRON_SECRET=your_cron_secret

PayPal Settings

PAYPAL_MODE=sandbox
PAYPAL_CLIENT_ID=your_client_id
PAYPAL_SECRET=your_secret
PAYPAL_CURRENCY=USD

Mail Settings

MAIL_MAILER=smtp
MAIL_HOST=your-smtp-host
MAIL_PORT=587
MAIL_USERNAME=your-email
MAIL_PASSWORD=your-password
MAIL_ENCRYPTION=tls
MAIL_FROM_ADDRESS=noreply@your-domain.com
MAIL_FROM_NAME="${APP_NAME}"

Directory Permissions

Ensure proper permissions are set for both applications:

WordPress Plugin

chmod -R 755 wp-content/plugins/kit-customizer
chmod -R 755 wp-content/uploads/kit-uploads
chmod -R 755 wp-content/uploads/kit-previews
chmod -R 755 wp-content/uploads/kit-print-files
chmod -R 755 wp-content/cache/kit

Laravel Portal

chmod -R 775 storage bootstrap/cache
chown -R www-data:www-data storage bootstrap/cache

Webhook Configuration

Configure WooCommerce webhooks to communicate with the licensing portal:

Go to WooCommerce > Settings > Advanced > Webhooks
Add new webhook for "Order Created" event
Set delivery URL to: https://your-domain.com/api/webhooks/woocommerce
Set secret key for HMAC signature verification
Repeat for "Order Updated", "Order Deleted" events

Previous Activate License Next Creating Products