melisplatform/melis-cms-prospects

Melis 平台潜在客户模块

v5.2.0 2024-06-06 07:28 UTC

README

MelisCmsProspects 为 Melis 平台提供完整的潜在客户系统,包括模板插件。

入门指南

以下说明将指导您在您的计算机上运行项目副本。
此 Melis 平台模块专为与 MelisCms 一起使用而设计。

先决条件

您需要安装 melisplatform/melis-cms 才能运行此模块。
当使用 composer 时,这会自动完成。

安装

运行 composer 命令

composer require melisplatform/melis-cms-prospects

数据库

数据库模型可在 MySQL Workbench 文件
/melis-cms-prospects/install/sql/model
数据库将通过 composer 和其钩子进行安装。
如果出现问题,SQL 文件位于此处
/melis-cms-prospects/install/sql

提供工具和元素

  • 潜在客户工具
  • 主题工具
  • Melis 模板潜在客户插件(联系表单与管理)
  • 潜在客户注册概览仪表板项目

运行代码

MelisCmsProspects 服务

MelisCmsProspects 为其他模块提供许多服务

  • MelisCmsProspects
    服务用于检索潜在客户列表、潜在客户详细信息并保存新的潜在客户
    文件:/melis-cms-prospects/src/Service/MelisCmsProspectsService.php
// Get the service
$melisProspectsService = $this->getServiceManager()->get('MelisProspectsService');
// Get the number of prospects per month
$nb = $melisProspectsService->getProspectsDataByDate('monthly', '2017-10-04 12:00:00');

MelisCmsProspects 表单

表单工厂

所有 Melis CMS 新闻表单都是使用表单工厂构建的。
所有表单配置均可在文件中找到:/melis-cms-prospects/config/app.tools.php
任何模块都可以通过在数组中构建键并在 Module.php 配置创建部分中合并来覆盖或添加此表单中的项。

return array(
	'plugins' => array(

		// MelisCmsProspects array
		'melistoolprospects' => array(

			// Form key
			'forms' => array(

				// MelisCmsProspects update form
				'melistoolprospects_tool_prospects_update' => array(
					'attributes' => array(
						'name' => 'prospectmanager',
						'id' => 'idformprospectdata',
						'method' => 'POST',
						'action' => '',
					),
					'hydrator'  => 'Laminas\Hydrator\ArraySerializableHydrator',
					'elements' => array(
						array(
							'spec' => array(
								...
							),
						),
					),
					'input_filter' => array(
						'pros_id' => array(
							...
						),
					),
				),
			),
		),
	),
),

表单元素

MelisCmsProspects 提供用于表单的表单元素

  • MelisCmsProspectThemeSelect:用于选择主题的下拉列表
  • MelisCmsProspectThemeItemSelect:用于选择主题项的下拉列表

使用自定义代码监听服务和更新行为

大多数服务都会触发事件,以便可以修改行为。

public function attach(EventManagerInterface $events)
{
	$sharedEvents      = $events->getSharedManager();

	$callBackHandler = $sharedEvents->attach(
		'MelisCmsProspects',
		array(
			'meliscmsprospects_toolprospects_save_end',
		),
		function($e){

    		$sm = $e->getTarget()->getServiceManager();
    		$params = $e->getParams();

    		// Custom code
    	},
    100);

    $this->listeners[] = $callBackHandler;
}

作者

有关参与此项目的贡献者列表,请参阅。

许可证

本项目采用 OSL-3.0 许可证 - 有关详细信息,请参阅 LICENSE.md 文件。