README

Textpattern CMS 模板标签，返回包含内容，其中所有搜索到的匹配项均被给定的替换项替换，类似于 PHP 的 str_replace 函数。

安装

$ composer require rah/rah_replace

或下载安装包。

基本

插件 rah_replace 为 Textpattern 的工具箱引入了一个新的容器标签。该标签返回用给定替换项替换所有找到的匹配项的包装内容。一个标签支持多个搜索匹配项和替换项。

<rah::replace from="value1, value2, ..." to="value1, value2, ...">
    Searched content
</rah::replace>

属性

<rah::replace>
    ...contained statement...
</rah::replace>

该标签是一个容器，其属性如下。

from
将搜索并用 to 属性的值替换的字符串。多个值用逗号（或 delimiter，如果已更改）分隔。
默认值：from="" 示例："dog,cat,house"

to
用于替换 from 属性值的替换项。如果是多个，则用逗号（或 delimiter）分隔。
默认值：to="" 示例："ship,home,hat"

delimiter
设置用于在 from 和 to 之间分隔多个值的分隔符。默认为逗号。
默认值：delimiter="," 示例："|"

示例

将 dog 替换为 cat

<rah::replace from="dog" to="cat">
    My favorite animal is a dog.
</rah::replace>

返回：我最喜欢的动物是一只猫。

替换多个针（匹配项）为不同的替换项

<rah::replace from="house,dog,Mike" to="boat,friend,wife">
    I live in a house with my dog and Mike.
</rah::replace>

返回：我和我的朋友和妻子住在一艘船上。

替换多个针（匹配项）为一个替换项

<rah::replace from="Mike,dad" to="I">
    I remember when dad and Mike did go to fishing.
</rah::replace>

返回：我记得我和我一起去钓鱼的时候。

使用不同的分隔符

默认情况下，任何逗号都被视为分隔符，不能用作实际值。要使用逗号（,）作为针或替换项，您必须将分隔符更改为其他值。例如，更改为垂直线

<rah::replace from=".|," to="!" delimiter="|">
    A, B, C.
</rah::replace>

返回：A! B! C!

变更日志

版本 0.5.0 – 2019/04/06

注册标签以实现 Textpattern >= 4.7.0 兼容性。
现在需要 Textpattern >= 4.7.0。

版本 0.4.2 – 2013/05/07

Composer 包使用 textpattern/installer 和 textpattern/lock。

版本 0.4.1 – 2013/04/25

小幅度清理。
作为 Composer 包发布。

版本 0.4 – 2012/07/12

性能优化。

版本 0.3 – 2011/04/22

性能优化。

版本 0.2 – 2009/04/16

添加了一个新属性：delimiter。

版本 0.1 – 2009/04/16

初始发布。

rah / rah_replace

维护者

详细信息