=== Help4 Builder Suite ===
Contributors: help4network
Tags: page builder, theme builder, templates, performance, seo, forms
Requires at least: 6.5
Tested up to: 7.0
Requires PHP: 8.1
Stable tag: 1.3.129
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Visual building, blank-theme templates, starter specs, icons, structured custom fields, sliders, SEO, performance, forms, Help4 Commerce, payment routing, and security tools for WordPress.

== Description ==

Help4 Builder Suite is the plugin layer for the Help4 blank-theme workflow. It gives site owners and builders the practical pieces they expect from a modern WordPress builder without forcing the theme to carry everything.

The suite includes:

* Visual page building with responsive controls.
* Theme builder support for global headers, footers, and reusable sections.
* A starter template library for common business, service, support, SEO, commerce, product, launch, recent-work, and SiteShot proof pages.
* A default SVG icon catalog so new sites do not start from an empty asset drawer.
* Structured field groups, repeaters, galleries, relationships, and dynamic rendering helpers.
* Slider-builder and SiteShot features for hero, promo, motion, recent-work, and website screenshot proof sections without loading slider assets everywhere.
* SEO metadata, FAQ schema helpers, performance tools, image optimization, forms, search, Help4 Commerce, payment routing, and security modules.
* Update-channel and Help4 Blank Theme dependency helpers.

Help4 Builder Suite is built for customers who want a lean theme, useful defaults, and a builder workflow that can scale from do-it-yourself page edits to done-for-you Help4 site builds.

== Installation ==

1. Upload the `help4-builder-suite` folder to `/wp-content/plugins/`.
2. Activate Help4 Builder Suite in WordPress.
3. Install or activate Help4 Blank Theme when prompted for best visual parity.
4. Open Help4 Builder Suite settings to configure brand, support, commerce, SEO, and builder defaults.
5. Use the template library and visual builder to start pages from proven structures.

== Frequently Asked Questions ==

= Does this require Help4 Blank Theme? =

The plugin can run on normal WordPress themes, but Help4 Blank Theme is recommended for clean frontend output and best builder parity.

= Is this a replacement for a normal theme? =

No. The theme stays intentionally lean. Help4 Builder Suite provides the visual builder, templates, icons, operations modules, and page systems.

= Can I use it for public client sites? =

Yes. Run the setup wizard, keep the plugin updated, verify responsive layouts, and use the included SEO and performance checks before publishing.

= Does it include starter templates? =

Yes. The current release ships with 89 starter specs and 117 default SVG icons.

= Is Help4 Commerce based on a third-party store plugin? =

No. Help4 Commerce is the native commerce path inside Builder Suite, with catalog, variation, subscription, product-context, and payment-router workflows built for Help4-managed sites.

== Changelog ==

= 1.3.129 =
* Expanded the SiteShot tutorial with seven rendered website screenshot examples, setup steps, troubleshooting, and copy-paste shortcode guidance.
* Cleaned public tutorial copy so the site now references 89 starter specs and 117 default SVG icons consistently.
* Removed legacy third-party product wording from public tutorial copy and release-source text.
= 1.3.128 =
* Added four SiteShot starter specs for recent work galleries, migration visual audits, website comparison proof, and support context pages.
* Added default SVG icons for website screenshots, SiteShot galleries, migration snapshots, and comparison proof.
* Advanced the starter seed marker to v12 and packaged the 1.3.127 SiteShot slider-frame fix into the public update channel.

= 1.3.127 =
* Improved slider site-shot rendering so slide-mode screenshots can use a flat frame without the browser-chrome strip.
* Added flat-frame CSS handling for slider site shots to keep image framing clean in fixed-height slider contexts.
* Hardened slider QA output paths so local interaction checks always write into the expected QA directory.
= 1.3.126 =
* Added an admin-only Release Bridge for authenticated tutorial/page batch updates and Builder Suite release publishing.
* Added application-password friendly release tooling so beta and live can receive plugin packages without hardcoded secrets.

= 1.3.125 =
* Added a starter-template seed lock so concurrent WP-CLI or admin loads cannot create duplicate default templates during release upgrades.
* Kept the 89 starter-spec and 117 default-icon release state intact while hardening upgrade behavior.

= 1.3.124 =
* Fixed robots.txt sitemap signaling so noindex or sitemap-disabled installs no longer advertise dead sitemap URLs.
* Added mirror-mode Elementor visibility fallbacks (`elementor-hidden-desktop/tablet/phone/mobile`) to prevent duplicate header/menu rendering when source theme assets are missing.
* Improved slider motion behavior so `fit=contain` no longer disables animation and dark side-fill appears for contain/none fit modes.
* Normalized list-block parsing so literal `\\n` values become real line breaks instead of merged list text.

= 1.3.123 =
* Added screenshot-led Builder Guide seed content so fresh installs and future reseeds keep the first-run walkthrough visual.
* Kept the public release package aligned with 89 starter specs, 117 default SVG icons, SiteShot starter pages, and WordPress 7 RC2 readiness.

= 1.3.122 =
* Cleaned package readme history so stale starter/icon counts do not look like current release guidance.
* Kept the shipped source aligned with the 89 starter-spec and 117 default-icon release state.
* Reconfirmed public package wording uses structured custom fields and Help4-native commerce language.

= 1.3.121 =
* Refreshed admin tutorial-hub count copy so the installed dashboard matches the 89 starter-spec release.
* Aligned public tutorial SEO copy with the then-current starter and bundled-icon release state.

= 1.3.120 =
* Added WP-CLI-safe starter seeding so release installs receive the current starter library during automated beta/stable package updates.
* Preserved the onboarding starter and default-icon catalog introduced for that release.

= 1.3.119 =
* Added eight more starter specs for service calculators, trust badges, migration checklists, comparison matrices, content calendars, video sales pages, support escalation, and FAQ hubs.
* Expanded the default SVG icon catalog to 101 icons with quote, trust, content, video, FAQ, and support-routing visuals.
* Advanced the starter seed marker so upgraded installs receive the new starter specs without recreating existing templates.

= 1.3.118 =
* Removed the planned store-scraper connector from the public importer UI so release builds only show ready connectors.
* Renamed the affiliate feed connector to the neutral `affiliate_feed_json` slug while preserving older saved feed payloads.
* Cleaned commerce import docs to match the ready connector catalog.

= 1.3.117 =
* Renamed commerce import connectors to Help4-native `store_rest` and `billing_bridge` slugs while silently accepting older saved connector values.
* Moved migration bridge settings to neutral billing-bridge option keys with fallback reads for existing installs.
* Cleaned bundled source/docs/admin copy so the public ZIP does not ship risky third-party product wording.

= 1.3.116 =
* Added a public starter-template export endpoint so library cards can copy specs on demand.
* Reduced the public template-library markup weight by moving starter JSON out of card attributes.
* Kept the 67-card starter browser intact while improving load and QA stability on heavier pages.

= 1.3.115 =
* Added a public `[h4_icon_library]` browser for the bundled default SVG icons with search, category filters, previews, and copyable icon slugs.
* Updated the default icon tutorial source page so users can inspect the actual bundled icons instead of reading only static guidance.

= 1.3.114 =
* Expanded the WordPress admin tutorial hub with clearer paths for templates, module controls, sliders/forms, and WordPress 7 upgrade readiness.
* Added stronger dashboard quick-start links so fresh installs can reach the public download, tutorial hub, and first-page guide faster.
* Refreshed public tutorial-page source content with chooser guidance for site owners who want the plugin path, done-for-you setup, commerce setup, launch QA, or update help.

= 1.3.113 =
* Raised the starter template library shortcode default so the full 67-spec catalog appears instead of the old 60-item cap.
* Added clearer use-case and next-step guidance to starter cards so new users can choose a template by job and know what to replace first.
* Updated seeded demo pages to request the full current starter set from the template browser.

= 1.3.112 =
* Added eight more starter specs for design handoff, local quote pages, review requests, buyer comparisons, case studies, migration rescue, knowledge-base indexes, and lead intake.
* Expanded the default SVG icon catalog to 92 icons with more onboarding, service, proof, documentation, and rollback visuals.
* Advanced the template seed marker so upgraded installs can receive the new starter specs without recreating existing templates.

= 1.3.111 =
* Hotfix: forced seeded Builder Suite screenshot URLs through the site URL path so HTTPS pages do not inherit an HTTP uploads base.

= 1.3.110 =
* Expanded the seeded Builder Suite product and plugin catalog pages with clearer plain-English use cases, release stats, screenshots, tutorial links, and download paths.
* Updated public seeded copy to the 59 starter spec and 80 default icon release counts.
* Added mobile-safe screenshot gallery styles for product/tutorial pages.

= 1.3.109 =
* Added eight more starter specs for quickstart installs, module control, global styles, product collections, checkout recovery, release notes, content briefs, and support articles.
* Expanded the default SVG icon catalog to 80 icons so fresh sites have more builder, update, commerce, and documentation visuals out of the box.
* Cleaned starter seed keys and legacy demo seeding so public installs keep Help4-native wording.

= 1.3.108 =
* Added a Help4 Builder Tutorial Hub to the plugin dashboard and WordPress dashboard widget.
* Linked plugin users to evergreen page tutorials for install, first page, templates, structured fields, commerce, and launch hardening.
* Kept md.help4wordpress.com tutorial links on the beta track while public installs use help4wordpress.com tutorial pages.

= 1.3.107 =
* Cleans public Builder Suite wording so field features are described as structured custom fields instead of referencing third-party product language.
* Adds richer public getting-started proof points for the release-site Builder Suite pages.

= 1.3.106 =

* Hotfix: removed hard-locked `/help4-beta/` dependency and update-channel URLs from public runtime settings.
* Keeps md.help4wordpress.com on the beta channel while letting live installs use the clean public Help4 WordPress package endpoints.

= 1.3.104 =

* Forced public robots.txt output to the working WordPress sitemap URL and kept md.help4wordpress.com blocked as the beta track.
* Preserved the PHP 8.1 compatibility hotfix and Help4 logo/favicon release build from 1.3.103.

= 1.3.95 =

* Updated the Help4 WordPress fallback homepage seed to use the cleaned public positioning and a real hero H1 so reseeds do not revive old mirrored copy.
* Cleaned remaining public seed copy for commerce wording and corrected encoded install-step arrows in the builder download page.

= 1.3.94 =

* Allowed Help4 redirect rules to send legacy account, checkout, and product paths to approved Help4-owned external hosts such as help4network.com without falling back to wp-admin.

= 1.3.93 =

* Switched the primary plugin and blank-theme update host to `plugins.help4wordpress.com`, while keeping md.help4wordpress.com as the working fallback until the new FTP-backed distribution host is populated.

= 1.3.92 =

* Added durable 301 redirects for old commerce and payment-router product aliases so future seeded pages keep search traffic on the clean Help4 Commerce and Help4 Payment Router URLs.

= 1.3.91 =

* Replaced the JSON-only product variant editor with a row-based variant matrix for SKU, attributes, price, stock, image ID, and sort order, while keeping JSON as an advanced bulk override.

= 1.3.90 =

* Added a product-editor variant matrix field so variable products can replace SKU, attribute, price, stock, image, and sort rows without relying only on imports or REST calls.
* Improved Commerce dashboard, product, subscription, import, and gateway admin screens with plain-language launch guidance for native catalog, subscription, and payment-router workflows.

= 1.3.89 =

* Removed the redundant seeded page subheading above the Starter Templates browser so mobile renders one clean headline before the template library.

= 1.3.88 =

* Cleaned up the seeded Starter Templates page so WordPress renders a single H1 for better SEO while keeping the full 51-template browser visible.

= 1.3.87 =

* Hid obsolete legacy store starter seeds from the public starter browser so upgraded installs show only Help4-native starter templates.

= 1.3.86 =

* Improved the public starter template browser so it shows only seeded starter specs, defaults to the full then-current starter set, and adds plain-language "best for" guidance.
* Added starter-library summary counts and readable default-icon chips to help customers choose a template without reading raw component names.
* Updated the seeded Feature Lab page and added a dedicated Starter Templates page to render the full then-current template catalog.

= 1.3.85 =

* Reworded visible billing/catalog bridge labels to Help4 Network language while keeping internal connector keys backward-compatible.
* Removed default bridge API paths that exposed implementation-specific billing-system wording in admin settings.

= 1.3.84 =

* Expanded the starter library with native commerce, subscriptions, payment routing, field-system, slider, blank-theme launch, commerce security, and large-catalog import pages.
* Expanded the default icon catalog for catalog import, variations, subscriptions, payment routing, checkout security, field groups, template conditions, and slider layers.
* Advanced the template seed marker so fresh installs and reseeds can pick up the new builder-onboarding starters.

= 1.3.83 =

* Upgraded Help4 Slider frontend controls with dots, pause/play, keyboard navigation, swipe gestures, hover pause, and reduced-motion handling.
* Added richer slide content fields for badge text, button text, and overlay positioning.
* Kept slider scripts/styles loaded only when slider shortcodes render.

= 1.3.82 =

* Added first-class subscription terms to native product editing.
* Checkout now detects subscription products, sends subscription context to payment-router endpoints, and creates subscription records from checkout with pending, active, or payment-failed status.
* Added `contains_subscription` routing conditions so recurring products can use dedicated gateway routes.
* Public product API responses now expose safe subscription terms for subscription products.

= 1.3.81 =

* Replaced lingering legacy store/router FAQ schema on commerce aliases with Help4 Commerce and Help4 Payment Router schema.
* Added source-backed FAQ seeds for commerce-support and payment-router product pages so future reseeds keep the corrected positioning.

= 1.3.80 =

* Hardened the anonymous payment gateway catalog so public requests no longer expose processor endpoints, account setting keys, or configured-account flags.
* Kept full gateway diagnostics available to site administrators.

= 1.3.79 =

* Repositioned public sales pages from legacy store/router language to Help4 Commerce and Help4 Payment Router.
* Added new seeded Help4 Commerce Support, Help4 Payment Router, and Payment Router plugin pages with legacy aliases marked noindex/canonical.
* Expanded Builder Suite public copy to describe structured custom fields, slider-builder features, Help4 Commerce, payment routing, security modules, and compartmentalized asset loading.
* Updated the starter template library commerce support entry to use Help4 Commerce naming.

= 1.3.78 =

* Hardened SEO metadata fallbacks so weak default WordPress site names do not leak into Open Graph output.
* Disabled execution of imported mirrored-page inline JavaScript on the local origin.
* Added strict Help4 package URL allowlists for plugin and theme update/install flows.
* Required a valid nonce before setup wizard skip state changes.
* Stopped trusting forwarded IP headers unless the remote address is an explicitly trusted proxy.
* Cleaned product-page feature markup for polished public sales pages.
* Added a public release readme.

= 1.3.77 =

* Expanded the starter library to 43 starter specs.
* Expanded the default icon catalog to 56 SVG icons.
* Hardened visual SEO QA support for large desktop and mobile checks.
