=== PufferGo ===
Contributors: puffergo
Tags: ai, website builder, landing page, b2b, seo
Requires at least: 6.7
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 0.9.53
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

AI-powered website builder. Quickly create high-performance, Google SEO-friendly beautiful websites.

== Description ==

**PufferGo** is an AI website builder crafted by a team of senior engineers from top-tier tech companies. Powered by world-leading large language models, it helps you rapidly generate beautiful websites optimized for Google SEO—empowering businesses to easily build their online presence for global markets.

= Why Choose PufferGo? =

* 🌏 **Optimized for Export & B2B** - Purpose-built for international trade and B2B business scenarios.
* 🔍 **Google SEO Friendly** - Semantic code structure that search engines love.
* ⚡ **Zero Coding Required** - No technical background needed. Launch your site in as little as one day.
* 📱 **Fully Responsive** - Perfect display on mobile, tablet, and desktop.
* 🚀 **Blazing Fast Performance** - Clean, minimal code for instant page loads.
* 🤖 **Top-Tier AI Models** - Integrated with world-leading large language models.

= Core Features =

* **AI Requirements Analysis** - Input your business info, and AI organizes your website requirements automatically.
* **Smart Sitemap Generation** - Auto-generates site structures following Silo architecture best practices.
* **Intelligent Block Planning** - Plans optimal page layouts based on each page's goals.
* **One-Click Website Generation** - AI generates complete pages instantly.
* **Flexible Editing Options** - Supports manual editing, AI-assisted editing, or importing HTML from other AI tools.
* **Theme Compatible** - Works seamlessly with your WordPress theme styles.

= Documentation & Support =

* 📖 **Documentation**: [puffergo.com/docs](https://puffergo.com/docs/why-puffergo/)
* 💬 **Chinese Support**: We provide comprehensive Chinese support to help Chinese businesses go global.
* 📧 **Email / 邮箱**: tech@puffergo.com
* 💬 **WeChat / 微信**: farfaraheader

== Installation ==

1. Search for **PufferGo** in WordPress Admin → Plugins → Add New, or manually upload the plugin to `/wp-content/plugins/puffergo`.
2. Activate PufferGo in the Plugins page.
3. Go to the **PufferGo** settings page to connect your account and start building.

== Frequently Asked Questions ==

= Is PufferGo free to use? =
Yes, we offer a free tier that's enough to create a complete website. More advanced features are available with paid plans.

= Do I need to know how to code? =
Not at all. We've eliminated all technical barriers, and top-tier AI models from both China and the US are here to assist you. If you run into any issues, feel free to contact us—we're happy to help. Of course, if you do have technical skills, you'll find it even smoother to use, but the difference isn't huge.

= How does it help with SEO? =
We generate Tailwind HTML code that's extremely clean and loads incredibly fast. Unlike traditional website builders (like Elementor), there's no bloated, redundant code.

= Where is the data stored? =
Only your account-related data is stored on our cloud servers. All other data remains on your own server.

== Screenshots ==

1. **Dashboard** - Clean account management panel and main feature entry points.
2. **Requirements Analysis** - Enter all the information you can think of, AI will analyze and organize your needs.
3. **Sitemap** - Smart generation of Silo architecture-compliant sitemaps.
4. **Block Planning** - Plans the most optimal page structure based on page goals.
5. **One-Click Generation** - AI generates your dream web pages with one click.
6. **Visual Editor** - Supports manual editing and AI editing, making everything work exactly as you want.

== Changelog ==

= 0.9.53 =

* **New: Blog System — Content Marketing Out of the Box** — Full-featured blog with archive page (category filtering, full-text search, responsive article grid, AJAX pagination), article detail page (breadcrumb navigation, prev/next navigation, related posts), and seamless AJAX comments to boost reader engagement and dwell time.
* **Improved: Visual Editor — More Efficient Editing** — New HTML source code editor modal with syntax highlighting for direct code editing and pasting external HTML. Fixed a bug where edits to multiple blocks could be lost during batch editing.
* **Improved: Sticky Header — Brand Always Visible** — Navigation bar now uses sticky positioning, keeping the menu accessible while scrolling and reducing bounce rate.

* **新功能：博客系统 — 内容营销开箱即用** — 一键拥有完整博客：归档页支持分类筛选和全文搜索，帮助访客快速找到感兴趣的内容；文章详情页自带相关推荐和上下篇导航，提升页面停留时间和 SEO 内链密度；无刷新评论系统，降低读者互动门槛，增强社区氛围。
* **改进：可视化编辑器 — 改版更高效** — 新增 HTML 源码编辑弹窗，语法高亮，支持直接粘贴外部代码导入；修复多区块同时编辑时修改丢失的问题，批量调整更安心。
* **改进：Header 吸顶 — 品牌始终可见** — 导航栏切换为吸顶模式，用户滚动浏览时导航始终可达，降低跳出率。

= 0.9.52 =

* **Refactor: Template Engine** — Ground-up rewrite of the template rendering pipeline with a declarative registry, auto-discovery of header/footer variants, and thin route architecture. New variants drop-in with zero code changes. Cleaner separation of concerns improves long-term maintainability.
* **Refactor: Data/UI Separation** — Introduced dedicated Data classes (`PufferGo_Product_Data`, `PufferGo_Archive_Data`, `PufferGo_Header_Data`, `PufferGo_Footer_Data`) to encapsulate all business logic. Templates are now pure presentation — thinner, testable, and easier to theme.
* **Refactor: CSS Architecture** — Consolidated 6 CSS files into 4 with clear single responsibilities: `puffergo.css` (theme defense & layout), `token-bridge.css` (design token mapping), `tailwind.css` (compiled utilities), `src/tailwind.css` (build source, excluded from production). Eliminated 4 duplicated reset blocks into a single scoped defense layer. Reduced compiled Tailwind output by ~33% via unified scope prefix.
* **Fixed: Cross-Theme Compatibility** — Extended button, input, textarea, and select element resets from header-only to all PufferGo-controlled areas (product archive, product detail, fullpage). Prevents theme style pollution from Kadence, GeneratePress, Astra and other popular themes. Scoped resets avoid `!important`, keeping Tailwind utility classes fully functional.
* **Fixed: CSS Load Order** — Block-level Tailwind CSS now correctly declares dependency on template Tailwind CSS, preventing mobile-first base utilities from overriding responsive breakpoint utilities.
* **Fixed: Product Spec Accordion** — Restored accordion toggle functionality on the product detail page. Added missing `data-toggle` attribute and plus/minus icon switching CSS.
* **Fixed: Contact Form i18n** — Default field labels in the contact form block are now properly wrapped for translation.

* **重构：模板引擎** — 模板渲染管线全面重写，采用声明式注册表 + 自动发现 header/footer 变体 + 薄路由架构。新增变体只需创建文件，零代码改动。关注点分离更清晰，长期可维护性显著提升。
* **重构：数据/UI 分离** — 引入专用 Data 类（`PufferGo_Product_Data`、`PufferGo_Archive_Data`、`PufferGo_Header_Data`、`PufferGo_Footer_Data`）封装全部业务逻辑。模板回归纯展示层，更薄、更可测试、更易定制。
* **重构：CSS 架构** — 6 个 CSS 文件合并为 4 个，职责单一：`puffergo.css`（主题防御与布局）、`token-bridge.css`（设计令牌映射）、`tailwind.css`（编译产物）、`src/tailwind.css`（构建源码，不打包进生产）。4 份重复防御代码合并为 1 个统一作用域，编译产物减少约 33%。
* **修复：跨主题兼容性** — button、input、textarea、select 元素重置范围从仅 header 扩展到所有 PufferGo 区域（产品列表、产品详情、全页模板）。防御 Kadence、GeneratePress、Astra 等主流主题的样式污染。作用域重置不使用 `!important`，Tailwind utility 类正常生效。
* **修复：CSS 加载顺序** — 区块级 Tailwind CSS 正确声明依赖模板 Tailwind CSS，避免 mobile-first 基础 utility 覆盖响应式断点 utility。
* **修复：产品规格手风琴** — 恢复产品详情页规格参数的折叠/展开功能。补上缺失的 `data-toggle` 属性和图标切换 CSS。
* **修复：联系表单国际化** — 联系表单区块的默认字段标签现已正确包裹翻译函数。

= 0.9.51 =

* **New: Product Video Gallery** — Product listing and detail pages now support video in the gallery. Add product videos alongside images to showcase features more effectively — rich media content improves user engagement and dwell time, both positive signals for Google SEO ranking.
* **Improved: i18n Architecture** — All translation keys migrated to English. Ready for WPML, Polylang, and other multilingual plugins. Contact form, design system, visual editor, and AI page builder are now fully translatable.
* **Fixed: Translation Scanner** — Dynamic strings now use `sprintf()` instead of template literals, fixing incomplete translation extraction.
* **Fixed: Missing Text Domain** — Added missing `puffergo` text domain in AI Page Builder.
* **Improved: Translation Files** — Regenerated `.po`, `.mo`, `.json` with complete Chinese translations.

* **新功能：产品视频画廊** — 产品列表页和详情页的 Gallery 现已支持视频。在产品图片中加入视频展示，更直观地呈现产品特性——丰富的多媒体内容提升用户参与度与页面停留时长，助力 Google SEO 排名。
* **改进：国际化架构** — 所有翻译键统一为英文，兼容 WPML、Polylang 等多语言插件。联系表单、设计系统、可视化编辑器、AI 建站全部支持翻译。
* **修复：翻译扫描** — 动态文案改用 `sprintf()`，修复翻译提取不全的问题。
* **修复：缺失 Text Domain** — 补充 AI Page Builder 中缺失的 text domain。
* **改进：翻译文件** — 重新生成翻译文件，中文翻译补全。

= 0.9.50 =

* **Fixed: Site Profile Logo Upload** — Resolved an issue where the site profile page could not upload or change the brand LOGO. The WordPress media library now loads correctly, ensuring smooth brand identity management across your entire site.
* **Fixed: Visual Editor Button Interaction** — Fixed a bug in the SectionTree visual editor where clicking on action buttons had no response when a non-first element was selected. All editing controls now work reliably regardless of which section is active.
* **Fixed: Video Media Selection** — The media picker in both the AI Edit Modal and PufferGo Tool now correctly supports video file selection, enabling richer multimedia content that improves user engagement and dwell time — both positive signals for search engine ranking.
* **Improved: AI Edit Image Reference** — Optimized the image reference attachment flow for AI-assisted editing: limited to one reference image per request for more focused results, with clearer user feedback when the limit is reached.
* **Improved: Element ID Tracking** — Enhanced the HTML preprocessing engine to correctly preserve and prefix element IDs when combining multiple blocks, preventing duplicate IDs and improving DOM structure quality for better SEO compliance.
* **Improved: Internationalization** — Updated English and Chinese translation files with new media picker strings for video selection support.

* **修复：站点画像 LOGO 上传** — 解决了站点信息页面无法上传或更换品牌 LOGO 的问题。WordPress 媒体库现在能正确加载，确保全站品牌标识管理顺畅无阻。
* **修复：可视化编辑器按钮交互** — 修复了 SectionTree 可视化编辑器中，选中非首个元素时操作按钮无响应的问题。无论选中哪个区块，所有编辑控件现在都能正常工作。
* **修复：视频媒体选择** — AI 编辑弹窗和 PufferGo 工具中的媒体选择器现已正确支持视频文件选择，方便添加更丰富的多媒体内容，提升用户参与度与页面停留时长——搜索引擎排名的正向信号。
* **改进：AI 编辑图片参考** — 优化 AI 辅助编辑的图片参考附件流程：每次请求限制为一张参考图，聚焦生成更精准的结果，超出限制时提供明确提示。
* **改进：元素 ID 追踪** — 增强 HTML 预处理引擎，在合并多个区块时正确保留并添加前缀元素 ID，避免重复 ID，提升 DOM 结构质量，更利于搜索引擎抓取与 SEO 合规。
* **改进：国际化** — 更新英文和中文翻译文件，覆盖新增的视频选择相关文案。

= 0.9.45 =

* **New: Customer Inquiry Management System** — Built-in WordPress contact form management module. Collect, view, and manage all customer inquiries from a dedicated admin panel with native Gutenberg block support — no third-party form plugin needed. Clean form markup improves Core Web Vitals scores.
* **New: In-Block Video Editing** — Edit videos directly within the WordPress block editor without switching tools or re-uploading files. Encourages richer media content that increases dwell time — a positive signal for Google SEO ranking.
* **New: Smart Full-Screen Loading Experience** — Professional full-screen loading overlay with randomized contextual tip messages during AI site generation. Reduces perceived wait time and decreases bounce rate for better user engagement metrics.
* **New: Default Page Template Configuration** — Set a default page template from the PufferGo settings panel. Newly created pages automatically inherit the configured template, ensuring brand and layout consistency. Consistent page structure helps search engines crawl and index pages more efficiently.
* **Improved: Post-Publish Page Preview** — Added a direct "View Page" button after AI site generation completes, eliminating extra navigation steps.
* **Improved: Streamlined Plugin Setup** — Consolidated all setup functionality into the main Settings panel, removing the standalone plugin installation page for a cleaner admin sidebar.
* **Improved: Design System Integration** — Comprehensive CSS architecture overhaul with Product CPT, unit config & formatter, nav menu helper refactor, CSS design tokens, and 60%+ reduction in theme bridge complexity.
* **Improved: Code Quality** — Optimized DOM tree output for cleaner HTML, shared debounce utility, updated end-to-end test coverage.
* **Improved: Internationalization** — Full translation coverage for English (en_US) and Chinese (zh_CN) across all new features.

* **新功能：客户询盘管理系统** — 全新内置 WordPress 询盘与联系表单管理模块，后台集中管理客户询盘，原生 Gutenberg 区块支持，无需第三方表单插件。干净的表单标记提升 Core Web Vitals 评分。
* **新功能：区块内视频编辑** — 在 WordPress 区块编辑器中直接编辑视频，无需切换工具或重新上传。更便捷的视频编辑鼓励产出更丰富的媒体内容，提升页面停留时长——搜索引擎排名的正向信号。
* **新功能：全屏加载体验与智能进度提示** — 专业全屏加载界面替代静态转圈动画，AI 建站过程中持续展示进度信息与操作提示。降低感知等待时间，有效减少跳出率。
* **新功能：默认页面模板配置** — 在 PufferGo 设置面板预设默认页面模板，新建页面自动继承已配置模板，确保全站品牌与布局一致性。统一的页面结构帮助搜索引擎更高效地抓取和索引。
* **改进：发布后一键查看页面** — AI 建站完成后新增"查看页面"按钮，一键直达已发布页面。
* **改进：插件安装流程合并至设置页** — 将安装配置功能整合到设置面板，移除独立安装页面，精简管理菜单。
* **改进：设计系统集成** — 全面 CSS 架构升级：产品 CPT、单位配置与格式化、导航菜单重构、CSS 设计令牌、主题桥接代码量减少 60%+。
* **改进：代码质量** — 优化 DOM 输出结构，减少冗余节点，生成更干净 HTML；新增共享 debounce 工具函数；更新端到端测试覆盖。
* **改进：国际化** — 英文与中文翻译文件全面更新，所有新功能文案覆盖率达 100%。

= 0.9.40 =
* Introduced PufferGo Product CPT — a lightweight WooCommerce alternative for faster product pages, boosting site speed and hitting the Google SEO sweet spot.
* Dedicated PufferGo Header & Footer menu locations — menus stay intact when switching themes, no more rebuilding.
* Step workflow now auto-creates product listing and blog archive pages and adds them to the navigation menu automatically.
* Improved header experience and removed redundant code.

* 注册 PufferGo Product 自定义文章类型，替代沉重的 WooCommerce，告别缓慢加载，网站速度飞起，直击 Google SEO 甜点。
* 独立创建 PufferGo Header 和 PufferGo Footer 菜单位置，无惧更换主题，主题随意切换菜单不变。
* Step 链路自动创建产品列表、博客列表页面并将产品列表和博客加入页面菜单中，菜单一次做好。
* 优化 Header 体验，删除冗余代码。

= 0.9.31 =
* Optimized core AI workflow with single batch request and polling pattern for improved stability and user experience.
* Moved admin menu position to top of sidebar (below Dashboard) for easier access.
* Improved form submission handling to ensure reliable data delivery.
* Enhanced thank-you page generation mechanism for better stability.
* 优化核心 AI 流程，改用单次批量请求与轮询结果模式，提升稳定性与用户体验。
* 调整后台菜单位置至侧栏顶部（仪表盘下方），更易访问。
* 优化表单提交处理逻辑，确保信息稳定送达。
* 优化感谢页生成机制，提高稳定性。
* Streamlined the account authorization flow so users can authorize with one click from anywhere in the product.
* 优化账号授权链路，方便用户从任何地方一键授权。
* Improved site info and brand persona inputs with templates and examples for multiple scenarios so users can follow along easily.
* 优化站点信息/品牌画像的输入，提供多种场景的模板和案例，用户依葫芦画瓢即可。
* Added error reporting to make troubleshooting easier.
* 上报错误信息，方便排查。
* Optimized long-running AI requests with cloud-side caching and front-end polling to reduce timeouts when the server is geographically distant.
* 优化 AI 长请求策略：采用云端缓存与前端轮询，避免因服务器距离过远导致超时。

= 0.9.2 =
* When the account is not connected, improved guidance to connect first before starting AI site building.
* Site profile: logo is selected from the Media Library (attachment ID with synced URL); updated size guidance (200–400 px width, upload 2× for retina displays).
* Unified header/footer logo rendering via puffergo_the_logo() and wp_get_attachment_image (srcset-friendly); fixed plugin load order so site profile helpers load before header/footer context.
* Refined logo-related admin strings and translations.
* 账号未连接时优化引导：更清晰提示先连接账号再开始 AI 建站。
* 站点信息：Logo 从媒体库选择（附件 ID + 同步 URL）；更新尺寸建议（宽度 200–400 px，建议上传 2 倍图以适配视网膜屏）。
* 统一页眉/页脚 Logo 输出（puffergo_the_logo() + wp_get_attachment_image，利于 srcset）；修正插件加载顺序，确保站点信息相关函数先于 header/footer context 加载。
* 优化 Logo 相关后台文案与翻译。

= 0.9.1 =
* Improved image SEO: AI generates contextual titles, alt text, and filenames optimized for Google SEO.
* When image search returns no results, placeholder images can be discovered via contextual keyword search.
* Fixed style conflicts caused by PufferGo template scope issues.
* Refined user flows and overall experience.
* 优化图片 SEO：根据上下文由 AI 生成有利于 Google 的图片 title、alt、filename 等信息。
* 图片搜索无结果时，占位图可通过上下文关键词继续搜索。
* 修复 PufferGo 模板作用域导致的样式错乱问题。
* 优化用户操作路径与整体体验。

= 0.9.0 =
* One-click plugin installation tailored to user scenarios.
* Improved interaction across the site generation flow.
* Multi-level guided onboarding for users.
* 根据用户场景，提供一键安装插件的能力。
* 优化网站生成链路的交互。
* 实现多层级引导用户。

= 0.8.9 =
* Optimized the Header and Footer templates. You can configure footer contact info, social media details, and menus from the admin dashboard.
* 优化 header 和 footer 模板：可在管理后台设置 footer 联系方式、社媒信息和菜单等。
* The design system can be restored to the theme default styles, and users with edit permissions can switch between styles.
* 设计系统支持恢复到主题默认样式&有编辑权限皆可切换。
* Site/page generation now supports multiple languages.
* 站点/页面生成支持多语言。
* Improved third-party AI-generated HTML import UX by moving it into a dedicated tab, increasing visibility and priority.
* 第三方 AI 生成的 html 导入功能提到 tab 里，提高权重和用户体验。
* During generation, `styleMode` is locked; during import, imports are locked to the Custom Creative mode.
* 生成时的 styleMode 锁定&导入锁定为自定义创意模式。

= 0.8.8 =
* Header: submenu support & theme-aligned styling.
* Footer: contact info support & theme-aligned styling.
* Overall plugin performance improvements.
* header 支持子菜单与样式跟随主题。
* footer 支持联系方式与样式跟随主题。
* 整体插件性能优化。

= 0.8.7 =
* Added documentation entry.
* Added feedback channel.
* 添加了文档入口。
* 添加了反馈渠道。

= 0.8.6 =
* AI Site Builder now sends generated keywords, title, and description directly to Rank Math SEO.
* Rank Math SEO keyword length increased to 6 (was 5 max).
* PufferGo Header Footer supports simple layout adjustments.
* AI建站生成的 keywords、title、description 直接写入 Rank Math SEO。
* Rank Math SEO 关键词长度设置为 6 个（原最多 5 个）。
* PufferGo Header Footer 支持调整简单布局。

= 0.8.5 =
* Refined the AI site-building flow to prioritize SEO, applying keyword strategy across the full journey so that every generated page is optimized for Google SEO from day one.
* WordPress theme styles can now be controlled via PufferGo AI design tokens, enabling a fully consistent visual style across your entire site.
* 对建站流程进行了改造，以 SEO 优先，全链路进行 SEO 关键词布局，确保页面生成即 Google SEO 最优。
* WordPress 主题样式现在也可通过 PufferGo AI 的 design tokens 设置，实现全站样式与品牌风格的统一。

= 0.8.2 =
* Third-party AI-generated HTML can be imported, supporting both inline and external CSS and JavaScript, and can import HTML containing canvas.
* 第三方AI生成的HTML可导入，可接受内联外联CSS和JavaScript，可导入包含canvas的HTML

= 0.8.1 =
* Update the cloud CDN alpine.js to a local file

= 0.8.0 =
* 🎉 Initial public beta release.
* Integrated AI Website Builder Engine.
* Added support for Tailwind CSS generation.
* Launched PufferGo AI connectivity.

== Upgrade Notice ==

= 0.8.2 =
We now support importing HTML in most formats, including HTML generated by platforms such as Claude Code, Gemini, OpenAI, GLM, and KIMI.
支持大部分形式的HTML导入啦，现在已经支持将Claude Code、Gemini、OpenAI、GLM、KIMI等平台生成的HTML导入啦

= 0.8.0 =
Welcome to PufferGo! This is the first public beta release.

== External Services ==

This plugin utilizes PufferGo AI services (api.puffergo.com) to provide artificial intelligence features:

* **Content Generation**: Sends prompts to generate text and layouts.
* **Template Sync**: Fetches the latest design patterns from our cloud library.

[Terms of Service](https://puffergo.com/terms) | [Privacy Policy](https://puffergo.com/privacy/)

This plugin supports optional third-party analytics services that are **disabled by default** and require manual activation:

= Google Tag Manager =
* **Service**: Google Tag Manager
* **Status**: Disabled by default, requires manual activation in plugin settings
* **Purpose**: Used to analyze website traffic and user behavior patterns.
* **Data Transmission**: May transmit user IP addresses and browser fingerprint information to Google's servers.
* **Privacy & Terms**: For detailed privacy and security information, please refer to [Google Privacy Policy](https://policies.google.com/privacy) and [Google Terms of Service](https://policies.google.com/terms)

= Baidu Analytics (百度统计) =
* **Service**: Baidu Analytics (百度统计)
* **Status**: Disabled by default, requires manual activation in plugin settings
* **Purpose**: Used to analyze website traffic and user behavior patterns for Chinese markets.
* **Data Transmission**: May transmit user IP addresses and browser fingerprint information to Baidu's servers.
* **Privacy & Terms**: For detailed privacy and security information, please refer to [Baidu Privacy Policy](https://www.baidu.com/duty/yinsiquan.html) and [Baidu Terms of Service](https://www.baidu.com/duty/)