README

CAMOO SMS - 为 WordPress 提供简单而强大的短信插件

您可以为 WordPress 添加发送短信到群组、用户、号码或仅向短信新闻订阅者成员的能力。

您可以针对 WordPress 的每个事件通过此插件发送短信。

此插件的使用完全免费。您只需要一个 CAMOO 账户

• 免费注册 CAMOO SMS 账户
• 向 CAMOO 团队请求新的 access_key 以供开发者使用

通过 PHP 代码发送短信非常简单

$to = array('+23761732567');
$msg = "Hello kmer World! Déjà vu!";
wp_camoo_sms_send( $to, $msg );

功能

• 向号码、订阅者和 WordPress 用户发送（批量）短信。
• 订阅短信新闻。
• 发送激活码以完成完整订阅。
• 当发布新文章时向订阅者发送通知短信。
• 当 WordPress 有新版本发布时发送通知短信。
• 当注册新用户时发送通知短信。
• 当收到新评论时发送通知短信。
• 当用户登录 WordPress 时发送通知短信。
• 当用户注册订阅表单时发送通知短信。
• 与（Contact form 7、WooCommerce、Easy Digital Downloads）集成
• 支持用于订阅者的 WordPress 小工具。
• 支持 WordPress Hooks。
• 支持 WP REST API。
• 导入/导出订阅者。
• 支持 GPG 加密，以确保您的服务器与我们的服务器之间端到端加密。
• 处理短信状态报告
• WooCommerce 集成：当状态更改后向买家发送短信
• 为电子商务的 Smobilpay 通知

安装

1. 将 camoo-sms 上传到 /wp-content/plugins/ 目录

   使用 GIT 安装

cd wp-content/plugins

git clone https://github.com/camoo/wp-camoo-sms.git camoo-sms

# install dependencies
./camoo-sms/bin/install_dependencies.sh

Install Using Composer

cd wp-content/plugins

composer require camoo/wp-camoo-sms

mv vendor/camoo/wp-camoo-sms camoo-sms

# install dependencies
./camoo-sms/bin/install_dependencies.sh

Install Manually

如果您不使用 Composer 来管理插件或其他依赖项，您可以手动安装此插件。从发行页面下载 wp-camoo-sms-Full.zip 文件，并将其解压到您的插件目录。

您还可以克隆此存储库，然后在插件文件夹中运行 composer install 以拉取其依赖项。

1. 通过 WordPress 中的“插件”菜单激活插件
2. 要显示订阅，请转到主题 -> 小工具，并将 SMS newsletter form 添加到您的侧边栏。或者，在主题中添加以下函数：<?php wp_camoo_sms_subscribes(); ?>。或者，在文章页面或小工具中使用此短码：[wp-sms-subscriber-form]。
3. 使用此函数发送手动短信

• 首先：$to = array('手机号码');
• $msg = "您的消息";
• $isflash = true; // 如果想要发送闪信，则保留此参数，否则可以从函数中删除此参数。
• 发送短信：wp_camoo_sms_send( $to, $msg, $isflash )

动作

当使用此插件发送短信时运行以下动作。

wp_camoo_sms_send

示例：发送短信时发送邮件。

function send_mail_when_send_sms($message_info) {
	wp_mail('you@mail.com', 'Send SMS', $message_info);
}
add_action('wp_camoo_sms_send', 'send_mail_when_send_sms');

当订阅新用户时运行以下动作。

wp_camoo_sms_add_subscriber

示例：当注册新订阅者时向用户发送短信。

function send_sms_when_subscribe_new_user($name, $mobile) {
    $to = array($mobile);
    $msg = "Hi {$name}, Thanks for subscribe.";
    wp_camoo_sms_send( $to, $msg )
}
add_action('wp_camoo_sms_add_subscriber', 'send_sms_when_subscribe_new_user', 10, 2);

过滤器

您可以使用以下过滤器来修改发件号码。

wp_camoo_sms_from

示例：将 0 添加到发件号码的末尾。

function wp_camoo_sms_modify_from($from) {
	$from = $from . ' 0';
	
	return $val;
}
add_filter('wp_camoo_sms_from', 'wp_camoo_sms_modify_from');

您可以使用以下过滤器来修改接收号码。

wp_camoo_sms_to

示例：添加新的号码以接收消息。

function wp_camoo_sms_modify_receiver($numbers) {
	$numbers[] = '67xxxxxxxx';
	
	return $numbers;
}
add_filter('wp_camoo_sms_to', 'wp_camoo_sms_modify_receiver');

您可以使用以下过滤器来修改文本消息。

wp_camoo_sms_msg

示例：向发送的消息添加签名。

function wp_camoo_sms_modify_message($message) {
	$message = $message . ' /n Powered By: WP-CAMOO-SMS';
	
	return $message;
}
add_filter('wp_camoo_sms_msg', 'wp_camoo_sms_modify_message');

示例：自动对REQUEST数据执行Satanise操作

if (isset($_POST['my_submit'])) {
	add_filter('my_filter', [\CAMOO_SMS\Admin\Helper::class, 'sanitizer']);
}
$input = \CAMOO_SMS\Admin\Helper::sataniseRequest('my_filter', $input);

REST API端点

添加新的订阅到短信新闻通讯

POST /camoosms/v1/subscriber/add