Installation

LANGA Tools is a standard WordPress plugin. It works on any self-hosted WordPress site — no page builder, no framework dependency.

Install Lite (free)

Lite is distributed as a .zip file. There are two ways to install it:

Install PRO

PRO is delivered as langa-tools-client.zip and is available after purchase from your Dashboard. Installazione follows the same upload procedure as Lite.

After activation, PRO asks for your license key — found in your dashboard order. Enter it under LANGA Tools → Settings → License.

Requirements

Activation

After installing the plugin, a few quick steps get everything running.

Lite activation

Lite activates automatically on plugin enable — no license key required. It connects to api.lan.ga on first load to register the site and start heartbeat sync.

You'll see a confirmation in LANGA Tools → Overview with the connection status badge.

PRO activation

Verify the connection

Open LANGA Tools → Settings → Debug. You'll see:

Plugin version   : 2.x.x
Plan             : pro / lite
Sync level       : standard / lite
Last heartbeat   : 2 min ago
Connection       : ✓ api.lan.ga — HTTP 200

If the connection shows an error, check that your server can make outbound HTTPS requests to api.lan.ga.

LANGA Connection

Every LANGA Tools installation maintains a persistent connection to the LANGA Galaxy infrastructure. This is the backbone of the service — it's how updates, telemetry, and license verification work.

What the connection tab shows

Under Settings → LANGA Connection you can see the real-time status of each Galaxy component:

Heartbeat

The plugin sends a lightweight heartbeat to api.lan.ga every 5 minutes. The heartbeat carries:

• Site domain and WordPress version
• PHP version
• Active plugin count
• Sync level (lite / standard)

The heartbeat is mandatory on Lite — it's the functional consideration for the free plan. On PRO it's also mandatory, but additional event types can be disabled.

Authentication

All requests are signed with HMAC-SHA256 using a site-specific token negotiated at first activation. The token is stored in wp_options and rotated every 30 days automatically.

Lite vs PRO

Lite is permanently free with no expiry. PRO unlocks all 10 modules, automatic updates, and direct support.

When a PRO license expires or is cancelled, the plugin reverts to Lite — the UI/UX module stays active, all PRO modules lock. No data is deleted.

Module: UI/UX

Your brand on every login screen, admin bar and front-end. Custom logo, built-by credits, maintenance mode, preloader, admin improvements.

Features

• Custom Login — replace the default WordPress login page with your logo, background colour and branding.
• Credits / Built by — show a branded "Built by" credit in the admin footer and optionally on the frontend.
• Maintenance Mode — lock the frontend with a branded maintenance screen during deployments. Admins bypass automatically.
• Preloader — optional animated page preloader, configurable per-site.
• Admin bar — unified admin bar with LANGA branding, links to Dashboard and quick actions.
• Admin UX improvements — cleaner wp-admin interface: remove clutter, standardise typography.
• User switching — switch to any user account directly from the admin bar (staff only).
• Ghost pages — create hidden pages not visible in navigation, useful for landing or test pages.
• Front-end UI improvements — optional tweaks to the public site (smooth scroll, mobile improvements).

Where to configure

LANGA Tools → Settings → UI/UX — tabs for Login, Credits, Maintenance, Preloader, Effects.

Module: Safer

Security hardening without a heavy plugin. Ghost Mode hides WordPress fingerprints, Door Access relocates the login URL, IP allowlist blocks threats at the application layer.

Features

• Ghost Mode — removes WP generator meta tag, version strings from assets, and other fingerprints visible to bots and scanners.
• Door Access — moves /wp-login.php to a custom URL. Anyone hitting the original URL gets a 404. Works with standard WP, WooCommerce, and most plugins.
• IP Allowlist — restrict wp-admin and/or login to specific IP addresses. Useful for client sites where admin access is always from known IPs.
• Login attempt logging — brute-force detection via the Events module (requires Events enabled).

Recommended setup

Enable features one at a time. Start with Ghost Mode (zero risk), then add Door Access. Note your custom login URL — if you lose it you'll need FTP/cPanel to reset it via wp-config.php:

define( 'LANGA_DOOR_ACCESS_SLUG', 'your-custom-slug' );

Module: SEO

Core SEO built in — XML sitemap, meta tags, Open Graph, JSON-LD Schema. No heavy external plugin needed.

Features

• XML Sitemap — auto-generated at /sitemap.xml. Includes posts, pages, custom post types. Pinged to Google and Bing on publish.
• Meta tags — per-post/page title, description, robots. Override the global defaults from the metabox on any post.
• Open Graph — og:title, og:description, og:image for social sharing. Uses featured image automatically.
• JSON-LD Schema — Organization, WebSite, BreadcrumbList. Data pulled from the company fields in the LANGA Tools data tab.
• Breadcrumbs — [langa_breadcrumbs] shortcode. Schema-marked up automatically.
• IndexNow — instant URL submission to Bing/Yandex on post save.
• Redirects — manage 301/302 redirects from wp-admin without a plugin.

Shortcodes

[langa_breadcrumbs]           ← breadcrumb trail with schema
[langa_sitemap]               ← HTML sitemap for a page

Module: Legal

GDPR-ready privacy policy, cookie policy and terms pages with an OPT-IN consent banner. Pages auto-fill from your company data — no manual editing required.

Features

• Auto-generated pages — Privacy Policy, Cookie Policy, Terms of Service created automatically using your company name, email, and country.
• Consent banner — customisable OPT-IN cookie banner. Saves consent per user in localStorage. Blocks third-party scripts until consent is given.
• Consent records — logs consent grants with timestamp and IP (anonymised after 48h) to wp_options.
• Shortcodes — embed policy content anywhere.

Shortcodes

[langa_privacy]               ← privacy policy content
[langa_cookies]               ← cookie policy content
[langa_terms]                 ← terms of service content
[langa_consent_status]        ← shows user's current consent

Configuration

Go to LANGA Tools → Settings → Legal. Fill in the Data tab (company name, address, email, VAT number) — all policies update automatically.

Module: Forms

Professional contact forms in 30 seconds. Per-form recipients, branded styling, spam protection, no external service.

Features

• Form presets — create named form configs (Contact, Quote, Support) from wp-admin. Each preset has its own recipient email, subject, and fields.
• Drag-and-drop fields — text, email, phone, textarea, select, checkbox, file upload.
• Spam protection — honeypot + optional server-side rate limiting. No CAPTCHA required.
• Branded emails — outgoing notifications use the LANGA Tools mail template (logo, company colours).
• Submission log — all submissions stored in wp_options for 30 days. Viewable in wp-admin.
• GDPR-aware — form data excluded from Events telemetry. Submissions never leave your server unless you configure a webhook.

Usage

[langa_form id="contact"]     ← embed form preset "contact"
[langa_form id="quote"]       ← embed form preset "quote"

Module: Cache

Browser cache headers, query string cleanup, emoji removal. Lightweight and reversible — measurable PageSpeed gains without a full caching plugin.

Features

• Browser cache headers — sets Cache-Control and Expires headers for static assets (images, CSS, JS). Configurable per file type and duration.
• Query string removal — strips version strings from asset URLs (?ver=6.4) so CDNs and proxies cache them correctly.
• Emoji removal — removes wp-emoji-release.min.js from every page load (saves ~10 KB per request, eliminates a DNS lookup).
• Heartbeat control — reduces or disables the WP heartbeat API on the frontend. Reduces CPU on shared hosting.
• Gravatar lazy load — defers Gravatar requests until they're in the viewport.

Module: Business Card

Digital business card with vCard download, team profiles, embedded map and QR code. Auto-reads company data — publish in one shortcode.

Features

• Company card — logo, name, address, phone, email, website, VAT. Rendered as a styled card embed.
• vCard download — .vcf file generated server-side, always in sync with your company data.
• Team profiles — add team members with photo, role, and contact details. Displayed as a grid or list.
• Embedded map — Google Maps or OpenStreetMap embed using the company address. No API key required for OpenStreetMap.
• QR code — auto-generated QR linking to the card URL or vCard download. Useful for print materials.

Usage

[langa_bc]                    ← full company card
[langa_bc type="team"]        ← team grid only
[langa_bc type="map"]         ← map embed only
[langa_bc type="qr"]          ← QR code only
[langa_bc type="vcard"]       ← download vCard button

Module: Events

Page events, form submissions, login attempts — logged locally with optional sync to the LANGA Intelligence dashboard. Zero configuration to start.

What gets logged

Sync to Intelligence

Events are stored locally in wp_options (rolling 90-day window) and optionally synced to api.lan.ga for the Intelligence dashboard. Sync is on by default on PRO — disable it under Settings → Events → Sync.

No personal data from your site's users is included in sync payloads — only technical stack data.

Module: AI In development

Centralised AI provider key management. LANGA Intelligence provides plugin analysis, compatibility, performance and error diagnostics directly in the admin panel.

Supported providers

• OpenAI — GPT-4o and later. Used for content suggestions, SEO meta generation.
• Anthropic — Claude models. Alternative to OpenAI for content tasks.
• Google — Gemini. Experimental support.

How to configure

Module: Popup

Smart triggers, scroll and exit-intent rules, full style control. No jQuery. No external service.

Trigger types

• Time delay — show after N seconds on page.
• Scroll depth — show when user scrolls past X% of the page.
• Exit intent — detect mouse leaving viewport (desktop) or back-swipe (mobile).
• Click trigger — open popup when a specific element is clicked (by CSS selector).
• Page rules — restrict popups to specific URLs, post types, or user roles.

Content

Popup content accepts raw HTML or shortcodes — including [langa_form], [langa_bc], or any third-party shortcode.

Usage

[langa_popup id="newsletter"]  ← trigger popup by id
[langa_popup id="offer" btn="Discover the offer"]

Sync protocol

Sync is the invisible layer that connects every LANGA Tools installation to the Galaxy infrastructure. It handles heartbeat, rule propagation, telemetry ingestion, and M2M authentication.

Sync levels

Endpoint

All sync traffic goes to https://api.lan.ga. The plugin posts to:

POST https://api.lan.ga/sync      ← heartbeat + events
POST https://api.lan.ga/auth      ← token negotiation
POST https://api.lan.ga/download  ← update check (PRO)

Authentication header

X-Langa-Sync-Token: {timestamp}.{HMAC_SHA256}

The HMAC is computed over timestamp + domain + sync_level using the site-specific secret stored in wp_options. Tokens are valid for 5 minutes.

Automatic updates

PRO licenses receive automatic plugin updates delivered directly from tools.lan.ga — no WP.org required.

How it works

On each WordPress update check cycle, the plugin queries api.lan.ga/download with the current version and license key. If a newer version is available and the license is valid, the update appears in Dashboard → Updates like any standard plugin update.

You can apply updates manually or enable auto-apply from Settings → License → Auto-update.

Update cadence

• Security patches — pushed immediately, auto-apply enabled by default.
• Bug fixes — typically within 1–3 days of detection.
• Feature releases — monthly or on major milestones.

Lite updates

Lite does not receive automatic updates. When a new Lite version is released, download the latest zip from tools.lan.ga/download and install over the existing version.

Frequently asked questions

define( 'LANGA_DOOR_ACCESS_RESET', true );