README

注意：该库不再受支持！

bx-helpers

1С-Bitrix平台上一款方便开发和支持项目的辅助库。

安装/配置

1. 通过Composer安装包（按照1С-Bitrix的建议，在/local/library/目录中）；

2. 转到管理面板中的命令行页面，并运行安装必要依赖的过程

use SavitskyiHub\BxHelpers\Helpers\Install\Mail_Install_Highload;
use SavitskyiHub\BxHelpers\Helpers\Install\User_Group_Install;

new Mail_Install_Highload("УКАЗАТЬ_ПРЕФИКС");
new User_Group_Install();

1. 在设置 -> 产品设置 -> 自动缓存 -> 清除缓存文件中，选择"全部"并点击"开始"；

2. 为邮件事件设置接收者

• 转到设置 -> 产品设置 -> 邮件事件 -> 邮件模板；
• 在"邮件事件类型"筛选器中填写"SAVITSKYI_BXHELPERS_HELPERS_MAIL"并转到邮件模板设置页面；
• 在"收件人"字段中填写必要的接收者地址（在出错的情况下，管理员会收到通知）；

1. 在init.php文件中添加以下代码

use Bitrix\Main\Application;
use Bitrix\Main\EventManager;

// Include Autoload
if (file_exists(Application::getDocumentRoot().'/local/library/vendor/autoload.php')) {
	require_once(Application::getDocumentRoot().'/local/library/vendor/autoload.php');
	
	if (class_exists('\SavitskyiHub\BxHelpers\Helpers\BeforeProlog')) {
		EventManager::getInstance()->addEventHandler('main', 'OnBeforeProlog', ['\SavitskyiHub\BxHelpers\Helpers\BeforeProlog', 'Init']);
	}
}

1. 在模板中连接必要的脚本和样式

use SavitskyiHub\BxHelpers\Helpers\Main\Includes;

// Для стилей
Includes::libraryCss();

// Для скриптов
Includes::libraryJs();

注意：放置在插件之后和项目脚本之前。

1. 在ПУТЬ_К_ДИРЕКТОРИИ_ШаБЛОНА/img/目录中上传必要的图像（主要确保它们存在）

• no-avatar.png;
• no-image.png;

1. 创建/upload/helpers/handbook_sprite/目录，否则无法创建手册的精灵图

检查工作

检查邮件和日志的发送（假设服务器已设置邮件），为此需要产生错误

• 在命令行中运行以下代码

use SavitskyiHub\BxHelpers\Helpers\Main\User;

$testDebug = User::getInstance();
$testDebug->TEST_DEBUG;

• 结果应该收到错误通知的邮件；
• 在文件/local/logs/helpers-debug.log中查看错误是否已被捕获；

删除

1. 转到管理面板中的命令行页面，并运行卸载依赖的过程

use SavitskyiHub\BxHelpers\Helpers\Install\Mail_Uninstall_Highload;
use SavitskyiHub\BxHelpers\Helpers\Install\User_Group_Uninstall;

new Mail_Uninstall_Highload("УКАЗАТЬ_ПРЕФИКС");
new User_Group_Uninstall();

1. 在init.php文件中删除安装中指定的连接代码；

2. 禁用安装中指定的样式和脚本连接；