README

该网站地图提供了一种机制，用于显示CakePHP可访问的一系列表中网站地图样式的信息（URL、更改频率、优先级和最后修改的日期时间）。

要求

• CakePHP 3.0.0+
• PHP 5.6+

安装

$ composer require loadsys/cakephp_sitemap

在您的 config/bootstrap.php 文件中，添加

Plugin::load('Sitemap', ['bootstrap' => false, 'routes' => true]);

或者

$ bin/cake plugin load Sitemap -r

用法

• 通过数组在 Sitemap.tables 中添加要显示网站地图记录的表列表

Configure::write('Sitemap.tables', [
	'Pages',
	'Sites',
	'Camps',
]);

• 同时还将 Sitemap.Sitemap 行为添加到每个表中

$this->addBehavior('Sitemap.Sitemap');

您现在可以通过 /sitemap.xml 访问网站地图。

配置

• Sitemap 行为的默认配置选项是

'cacheConfigKey' => 'default',
'lastmod' => 'modified',
'changefreq' => 'daily',
'priority' => '0.9',
'conditions' => [],
'order' => [],
'fields' => [],
'implementedMethods' => [
	'getUrl' => 'returnUrlForEntity',
],
'implementedFinders' => [
	'forSitemap' => 'findSitemapRecords',
],

• 例如，要更改列出记录时的 changefreq，请按如下方式更新相关 Table 的 addBehavior 方法调用

$this->addBehavior('Sitemap.Sitemap', ['changefreq' => 'weekly']);

• 要自定义为每条记录生成的URL，请在匹配的 Table 类中创建一个名为 getUrl 的方法。

public function getUrl(\Cake\ORM\Entity $entity) {
	return \Cake\Routing\Router::url(
		[
			'prefix' => false,
			'plugin' => false,
			'controller' => $this->registryAlias(),
			'action' => 'display',
			$entity->display_id,
		],
		true
	);
}

• 要自定义显示网站地图时使用的模板，CakePHP手册提供了有关 覆盖插件模板 的信息。

贡献

行为准则

本项目采用了贡献者公约作为其 行为准则。所有贡献者都应遵守此准则。 翻译可用。

报告问题

请使用 GitHub Issues 列出任何已知的缺陷或问题。

开发

在开发此插件时，请进行分支并发出新的PR。

设置工作副本

$ git clone git@github.com:YOUR_USERNAME/CakePHP-Sitemap.git
$ cd CakePHP-Sitemap/
$ composer install
$ vendor/bin/phpcs --config-set installed_paths vendor/loadsys/loadsys_codesniffer,vendor/cakephp/cakephp-codesniffer

进行您的更改

$ git checkout -b your-topic-branch
# (Make your changes. Write some tests.)
$ vendor/bin/phpunit
$ vendor/bin/phpcs -p --extensions=php --standard=Loadsys ./src ./tests

然后提交并推送您的更改到您的分支，并打开一个拉取请求。

许可证

MIT

版权

Loadsys Web Strategies 2016