Installation & license

Install the core plugin on WordPress/WooCommerce and activate your license key. Takes about five minutes.

Before you start

  • WordPress 6.0+, WooCommerce 6.0+ (installed and active), PHP 8.0+.
  • A writable WordPress uploads directory and the PHP GD extension.
  • ZipArchive + Sodium if you install official signed addons.
  • Your purchase email from Lemon Squeezy — it contains the plugin ZIP download link and your license key. You can re-download both any time from your Lemon Squeezy "My Orders" page.

Install the plugin

  1. Download the plugin ZIP

    Open your purchase receipt email from Lemon Squeezy and download veyo-product-personalizer.zip. Don't unzip it — WordPress wants the ZIP as-is.

  2. Upload it in WordPress admin

    Go to Plugins → Add New Plugin → Upload Plugin, choose the ZIP, and click Install Now.

  3. Activate the plugin

    Click Activate Plugin when the install finishes. A Veyo menu appears in your WordPress admin sidebar.

  4. Enter your license key

    Open the Veyo License screen, paste the key from your Lemon Squeezy order, and click Activate. The key authorizes paid package installs, manual updates, and support eligibility.

Two activation slots. Use them for one production site and one staging site. A third local or test site requires deactivating a slot first. Moving domains? Deactivate the old instance before activating the new one.

Server packages and extensions

Only the first group is required for the designer. Add production tools when your workflow actually exports server-rendered raster, CMYK, or PDF/X files. Open Veyo → Dashboard after every server change: it separates core failures from package-management checks and optional production warnings.

GroupPackageUsed for
CoreGDNormal image handling, previews, and baseline designer operation.
PackagesZipArchiveOpening addon ZIPs and production download archives.
PackagesSodiumEd25519 verification of official addon signatures.
Optional productionImageMagick CLI or ImagickServer-rendered PNG and TIFF output.
Optional productionlibrsvg / rsvg-convertAccurate SVG-to-raster rendering, especially nested SVG layers.
Optional productionGhostscriptPDF/X output only.
Optional productionCMYK ICC profileCertified CMYK TIFF and PDF/X color conversion.

cPanel, Plesk, and shared hosting

  1. Switch the site to PHP 8.x in MultiPHP Manager, Select PHP Version, or Plesk PHP Settings.
  2. Enable gd, zip/ZipArchive, sodium, and—if your host offers it—imagick.
  3. Save/apply the PHP configuration. Managed panels normally restart the correct PHP handler automatically.
  4. If an extension is not listed, ask the host to enable it. On shared hosting you normally cannot install rsvg-convert or Ghostscript yourself.
  5. Return to Veyo → Dashboard and reload the checks.
CLI execution can be disabled by the host. If PHP lists a command-line package but Veyo cannot execute it, the Dashboard still reports that CLI tool as unavailable. Imagick can continue working through the PHP extension.

Debian or Ubuntu

sudo apt update
sudo apt install php-gd php-zip php-common imagemagick librsvg2-bin ghostscript
php -m | grep -Ei 'gd|zip|sodium|imagick'
rsvg-convert --version
gs --version

Sodium is part of modern PHP builds; php-common normally provides it. If you use PHP-FPM, restart the installed service version, then restart or reload the web server:

sudo systemctl restart php8.3-fpm
sudo systemctl reload nginx   # or: sudo systemctl reload apache2

RHEL, Rocky Linux, AlmaLinux, or Fedora

sudo dnf install php-gd php-zip php-sodium ImageMagick librsvg2-tools ghostscript
php -m | grep -Ei 'gd|zip|sodium|imagick'
rsvg-convert --version
gs --version
sudo systemctl restart php-fpm
sudo systemctl reload nginx   # or: sudo systemctl reload httpd

Package names vary between the distribution repositories and Remi streams. Use the package matching the PHP version that serves WordPress—not a second command-line PHP installation.

macOS local development

brew install php imagemagick librsvg ghostscript
php -m | grep -Ei 'gd|zip|sodium|imagick'
rsvg-convert --version
gs --version

Restart Valet, Herd, Local, MAMP, or your PHP-FPM service after changing PHP. A Homebrew CLI package does not automatically enable the Imagick PHP extension; Veyo accepts either Imagick or the ImageMagick CLI.

What happens when a package is missing?

MissingImpactStill works
GDCore image workflows are unsupported.Fix before using Veyo in production.
ZipArchiveAddon ZIP install and ZIP-based downloads fail.Designer pages already installed can load.
SodiumOfficial signed addon installation cannot be verified.Core designer and existing addons continue.
ImageMagick / ImagickNo server PNG/TIFF raster pipeline.Designer, browser preview, and SVG output.
rsvg-convertSVG rasterization falls back to ImageMagick/Imagick and nested SVG may shift.Designer, SVG export, previews, and fallback raster where ImageMagick exists.
GhostscriptNo PDF/X output.Designer, previews, SVG, PNG/TIFF, and non-PDF/X workflows.
CMYK ICC profileNo certified CMYK TIFF/PDF-X conversion.RGB output and normal designer workflows.

After installing packages and restarting PHP/web services, reload Veyo → Dashboard. A yellow optional warning is informational; a red core requirement needs action.

Updating

Core: open Lemon Squeezy My Orders, download the new veyo-product-personalizer-vX.zip, then use Plugins → Add New Plugin → Upload Plugin and confirm overwrite of the existing folder.

Addons: download each signed addon ZIP from My Orders, open Veyo → Apps, and upload it. Custom or legacy builds use Restore official ZIP; Veyo verifies signature, expected slug, and paid entitlement before overwrite.

Unsigned custom addons require an explicit warning checkbox and are not activated automatically. A package with an invalid signature, unknown key, or hash mismatch is always rejected.

Uninstalling

Deactivate and delete the plugin from the Plugins screen. Your product configurations and saved customer designs remain in the database, so reinstalling later picks up where you left off.

← Overview Next: Your first product →