WordPress Plugin

The FastLinkIt WordPress plugin (v1.4.0) is a comprehensive integration that brings URL shortening, payments, donations, fundraising, newsletter signups, and contact forms to your WordPress site.

Installation

1. Upload the fastlinkit folder to /wp-content/plugins/
2. Activate the plugin in WordPress
3. The Setup Wizard launches automatically on first activation

Setup Wizard

The 5-step wizard guides you through initial configuration:

1. Welcome — overview of the plugin and its capabilities
2. Create Account — sign up for FastLinkIt (or skip if you already have one)
3. Connect Stripe — link your Stripe account for payments (can be done later)
4. API Key — enter your API key and test the connection
5. Done — shows available shortcodes and warns if your domain isn't in the authorised domains list

The wizard auto-detects your ticket manager and shows a setup guide for the contact form.

Settings Tabs

After setup, the plugin settings page at Settings → FastLinkIt has nine tabs:

Your Account

• API key input and connection test
• Account status (plan, email, Stripe Connect status)
• Links to your FastLinkIt dashboard, subscription, and pricing

General

• API Base URL — the FastLinkIt server URL (default: https://flnk.it)
• Short Code Prefix — optional prefix for generated short codes
• Auto-Shorten — automatically shorten all external links in posts/pages on save
• SSL Handling — for localhost development, allows disabling SSL verification

Payments

• Enable Payments — master toggle for payment features
• Default Size — form size for [flnkit_pay] shortcode (small/medium/large/full)
• Webhook Registration — auto-registers with FastLinkIt API, stores HMAC secret
• Stripe Connect Status — shows whether your Stripe account is connected

Donations

• Default Size — form size for [flnkit_donate] shortcode
• Default Amount — pre-filled donation amount
• Default Currency — default currency code
• Button Text — default donation button label

Fundraising

• Default Size — form size for [flnkit_fundraise] shortcode
• Campaign Selector — dropdown of your campaigns for quick shortcode copying
• Create Campaign — create campaigns directly from WordPress with:
  • Title, description, target amount, currency
  • Image upload via WordPress Media Library
  • Suggested amounts, min/max donation
  • Custom amount toggle, end date, thank you message, short code
• Preview shortcode generated after creation

Mailing

• Subscribe Form Settings — defaults for the [flnkit_subscribe] shortcode
• Default size, button text, button colour, show name field toggle
• Default title and description text
• Group selection (which groups subscribers join)

Products

• Product List — view your FastLinkIt products with name, price, status
• Quick Shortcode — click any product to copy its [flnkit_pay] shortcode
• Create Product — create products directly from WordPress

Tickets

• Contact Form Settings — defaults for the [flnkit_contact] shortcode
• Default size, show priority toggle, show department toggle
• Default department selection
• License status and domain authorisation check

Help

• Shortcode reference with examples
• Links to documentation, API docs, and support
• Plugin version and system info

Shortcodes

The plugin provides five shortcodes for embedding FastLinkIt features on your site.

[flnkit_pay] — Payment Button

Renders a checkout button for selling products or accepting one-off payments.

Examples:

[flnkit_pay amount="29.99" currency="gbp" description="Premium eBook" button_text="Buy Now"]

[flnkit_pay product_id="your-product-guid" button_text="Purchase" size="large"]

[flnkit_donate] — Donation Button

Renders a donation button with optional preset amounts.

Example:

[flnkit_donate amount="5" currency="gbp" description="Buy me a coffee" button_text="Support Us"]

[flnkit_fundraise] — Fundraising Campaign Widget

Renders a complete fundraising widget with progress bar, suggested amounts, and donor form.

The widget displays:

• Campaign image and description
• Progress bar with raised amount vs target and percentage
• Suggested amount buttons (highlighted on selection)
• Custom amount input (if enabled on the campaign)
• Donor form: name, email, message, anonymous checkbox
• Donate button with loading state

Example:

[flnkit_fundraise campaign_id="community-garden"]

[flnkit_subscribe] — Newsletter Subscribe Form

Renders a subscribe form for visitors to join your mailing lists.

The form includes:

• Email input (required)
• Name input (optional, controlled by show_name)
• Group checkboxes (if multiple groups selected)
• Subscribe button with loading state
• Success/error messages

Examples:

[flnkit_subscribe groups="all" title="Newsletter" description="Stay updated with our latest news."]

[flnkit_subscribe groups="group-id-1" show_name="true" size="large" color="#16a34a"]

[flnkit_contact] — Contact / Ticket Form

Renders a contact form that creates a support ticket in FastLinkIt.

The form includes:

• Name, email, subject, message fields
• Optional priority selector (Low/Normal/High/Urgent)
• Optional department dropdown (fetched from your organisation)
• File attachment upload
• Submit button with loading state

Examples:

[flnkit_contact show_department="true" size="large"]

[flnkit_contact department="department-guid" show_priority="false"]

Configurable Form Sizes

All shortcodes support four size options:

Default sizes are set per shortcode in the plugin settings and can be overridden per instance via the size attribute.

Campaign Creation from WordPress

You can create fundraising campaigns directly from the WordPress admin without visiting the FastLinkIt dashboard:

1. Go to Settings → FastLinkIt → Fundraising tab
2. Fill in the campaign form:
   • Title, description, target amount, currency
   • Click Select Image to use the WordPress Media Library for the campaign image
   • Set suggested amounts, min/max donation, custom amount toggle
   • Set an end date and thank you message
   • Choose a short code
3. Click Create Campaign
4. The generated shortcode (e.g., [flnkit_fundraise campaign_id="..."]) is shown for copying

Auto-Shorten Links

When enabled in the General tab, the plugin automatically shortens all external links in your posts and pages when you save them:

• Scans the post content for <a href> tags pointing to external URLs
• Creates short links via the FastLinkIt API
• Replaces the original URLs with short URLs
• Plan-aware: stops shortening when your link limit is reached (the post still saves normally)
• Retries on short code conflicts (409)
• Works with both Gutenberg and Classic editor

Sidebar Meta Box

A meta box on the post/page editor lets you manually shorten any URL via AJAX without saving the post.

SSL Handling for Localhost

For local development, the plugin includes an SSL handling option in the General tab. When your FastLinkIt instance uses a self-signed certificate (common in localhost development), enable this option to allow the plugin to connect without SSL verification errors.

Domain Authorisation

Make sure your WordPress site's domain is added to Organisation → Authorised Domains in FastLinkIt. The setup wizard checks this automatically and shows a warning if the domain isn't authorised. This is required for:

• Payment processing ([flnkit_pay], [flnkit_donate])
• Fundraising donations ([flnkit_fundraise])
• Contact form submission ([flnkit_contact])
• Subscribe forms ([flnkit_subscribe])