Freemius WordPress SDK 使用教程

1. 项目介绍

Freemius WordPress SDK 是一个开源的软件开发工具包（SDK），专为 WordPress 插件和主题开发者设计。通过集成 Freemius SDK，开发者可以轻松实现软件许可、安全支付、订阅管理、自动更新、欧盟增值税处理、购物车放弃恢复、联盟平台、分析和用户仪表盘等功能。Freemius 平台旨在帮助开发者创建繁荣的订阅型业务。

2. 项目快速启动

2.1 安装 Freemius SDK

首先，你需要将 Freemius SDK 集成到你的 WordPress 插件或主题中。以下是快速启动的步骤：

1. 下载 SDK: 从 Freemius GitHub 仓库 下载最新的 SDK 文件。
2. 集成 SDK: 将下载的 SDK 文件放置在你的插件或主题的根目录中。
3. 初始化 SDK: 在你的主插件文件或主题的 functions.php 文件中添加以下代码来初始化 SDK。

if ( ! function_exists( 'my_prefix_fs' ) ) {
    // Create a helper function for easy SDK access.
    function my_prefix_fs() {
        global $my_prefix_fs;
        if ( ! isset( $my_prefix_fs ) ) {
            // Include Freemius SDK.
            require_once dirname(__FILE__) . '/freemius/start.php';
            $my_prefix_fs = fs_dynamic_init( array(
                'id'             => '1234', // 你的 Freemius ID
                'slug'           => 'my-new-plugin',
                'premium_slug'   => 'my-new-plugin-premium',
                'type'           => 'plugin',
                'public_key'     => 'pk_bAEfta69seKymZzmf2xtqq8QXHz9y',
                'is_premium'     => true,
                'has_premium_version' => true,
                'has_paid_plans' => true,
                'is_org_compliant' => true,
                'menu'           => array(
                    'slug'       => 'my-new-plugin',
                    'parent'     => array(
                        'slug' => 'options-general.php',
                    ),
                ),
                'secret_key'     => 'sk_ubb4yN3mzqGR2x8#P7r5&@*xC$utE', // 仅用于开发和测试
            ) );
        }
        return $my_prefix_fs;
    }
    // Init Freemius.
    my_prefix_fs();
    // Signal that SDK was initiated.
    do_action( 'my_prefix_fs_loaded' );
}

2.2 配置 Freemius

在 Freemius 开发者仪表盘（Freemius Dashboard）中完成 SDK 的配置，并生成相应的初始化代码片段。将生成的代码片段粘贴到你的插件或主题的主文件中。

3. 应用案例和最佳实践

3.1 应用案例

Freemius SDK 广泛应用于各种 WordPress 插件和主题中，例如：

• WooCommerce 扩展: 通过 Freemius 实现订阅和支付功能。
• 高级主题: 使用 Freemius 管理许可证和自动更新。
• SEO 插件: 集成 Freemius 进行用户分析和付费计划管理。

3.2 最佳实践

• 安全性: 确保在生产环境中移除 secret_key，以防止安全漏洞。
• 用户体验: 使用 Freemius 的用户仪表盘功能，提供用户友好的界面。
• 合规性: 遵循 WordPress.org 的指南，确保免费版本不包含付费功能代码。

4. 典型生态项目

Freemius SDK 与以下 WordPress 生态项目紧密结合：

• WooCommerce: 用于扩展 WooCommerce 功能的插件。
• Elementor: 用于创建高级页面构建器的插件。
• Yoast SEO: 用于搜索引擎优化的插件。

这些项目通过 Freemius 实现了高级功能的管理和付费订阅的集成。

---

通过本教程，你应该能够快速上手并集成 Freemius SDK 到你的 WordPress 项目中。如果你有任何问题，可以参考 Freemius 官方文档 获取更多帮助。