webprofy / include
为Bitrix提供的可编辑包含区域组件
Requires
- php: ^5.3.3 || ^7.0
- composer/installers: ~1.0
This package is not auto-updated.
Last update: 2024-09-29 23:05:21 UTC
README
任何网站都可以用静态HTML文件构建,但维护起来不方便。通常,Bitrix网站由静态和动态部分组成。动态部分通常基于信息块构建,而静态部分则基于简单的PHP文件。如果程序员正确配置了视觉编辑器的样式和代码片段,那么他可以简化内容管理员的静态页面工作。
但如何编辑复杂的布局呢?
“可编辑区域”组件作为一个内置的Bitrix“包含区域”组件工作,但它允许就地编辑复杂的布局。
安装
使用Composer
composer require webprofy/include
手动
将存储库克隆到项目中的 local/components/webprofy/include 文件夹
连接
组件无需模板即可工作。唯一的参数是 FILE,它是指向包含区域的文件路径。
<?$APPLICATION->IncludeComponent("webprofy:include", "", array('FILE'=>'/include/main_intro.php')); ?>
工作原理
在正常模式下,组件只是输出文件内容。只有当Bitrix的“编辑模式”开启,并且用户具有编辑包含文件的权限时,才能激活编辑器。
在右上角的标准Bitrix设置面板旁边,还有一个“编辑”按钮,点击它可以启动编辑模式。
默认情况下,整个区域都是可编辑的,但在这个模式下,内容管理员有可能会破坏布局。可以通过特殊标记限制编辑功能。
文件标记
在指定标签内的 data-editable
属性中,连接了具有有限功能的编辑器,即只有 粗体、斜体 和 链接。换行或插入图片不可用。
在 <img />
的 data-editable
属性中,可以通过拖放替换此图像。
在指定区域的同时具有 data-rich
和 data-editable
属性时,连接了完整的编辑器,即具有换行、插入标题和上传图片的能力。
图片上传
所有图片都上传到 /upload/webprofy_include/ 文件夹。
待办事项
data-repeatable
用于复制/删除布局块- 上传后调整图片大小
- 上传大图片时出现问题(POST请求无法通过)
medium-editor
使用 medium-editor 作为内置编辑器。