waughj/wordpress-links

WordPress插件,用于轻松生成链接。

v1.0.2 2019-06-26 17:53 UTC

This package is auto-updated.

Last update: 2024-09-27 06:09:55 UTC


README

通过PHP和简码,更容易地在内容中创建各种类型的链接。

描述

此插件包含6种简码/PHP类

链接

简码: [link href="url"]内容[/link] PHP类: new WaughJ\HTMLLink\HTMLLink( $href, $content, $other_attributes );

通用链接,其中提供的链接href直接用作href。所有其他链接类型的骨架。

内容,当置于开闭标签之间时,可以是自己的简码,它也会被解释。当用作PHP类时,可以将任何可以用作字符串的对象作为内容推送,包括其他HTML生成器。

有效属性包括所有有效的HTML5 a标签属性,以及...

  • 一个“锚点”属性,它将锚点添加到href(#之后的部分)。
  • 一个“参数”属性,它将GET参数添加到href(例如?first_parameter=second_value&second_parameter=second_value)。
  • 一个“外部”属性,当设置为“true”时,会自动添加HTML以使链接在新标签页中打开并防止被黑客攻击。(有关安全问题的更多信息,请参阅https://www.jitbit.com/alexblog/256-targetblank---the-most-underestimated-vulnerability-ever/)。

邮件链接

简码: [mail-link]电子邮件[/mail-link] 或 [mail-link email="电子邮件"]电子邮件给我。[/mail-link] PHP类: new WaughJ\HTMLMailLink\HTMLMailLink( $email, $other_attributes );

生成mailto链接。如果只给出电子邮件,则内容自动设置为电子邮件。

有效属性包括用于内容的“value”(用于直接PHP使用)。所有有效的HTML5 a标签属性以及之前在链接中提到的“外部”属性。

电话链接

简码: [phone-link]电话号码[/phone-link] 或 [phone-link tel="电话"]现在就联系我们![/phone-link] PHP类: new WaughJ\HTMLPhoneLink\HTMLPhoneLink( $phone_number, $other_attributes );

生成tel链接。如果只给出电话号码,则内容自动设置为电话号码。

有效属性包括用于内容的“value”(用于直接PHP使用)。所有有效的HTML5 a标签属性以及之前在链接中提到的“外部”属性。

帖子链接

简码: [post-link slug="post-slug"] 或 [post-link slug="post-slug" post_type="specific-post-type"] [post-link post_id="post-id"]阅读此帖子[/post-link] PHP类: new WaughJ\WPPostLink\WPPostLink( $attributes );

基于slug或post_id生成指向帖子的链接,或者如果使用PHP类,则在“post”下使用帖子对象本身。

此外,您可以添加所有可用的常规链接类和简码的属性。

主页链接

简码: [home-link] 或 [home-link]访问我们的主页。[/home-link] PHP类: new WaughJ\WPHomeLink\WPHomeLink( $attributes );

自动生成指向WordPress主页的链接。代表链接的内容默认为主页名称。所有其他替代属性的处理方式与常规链接类和简码相同。

分类链接

简码: [category-link slug="category-slug"] 或 [category-link category_id="category-id"]链接内容[/category-link] PHP类: new WaughJ\WPCategoryLink\WPCategoryLink( $attributes );

自动生成指向分类页面的链接。使用slug或category_id属性获取分类。内容以及可选属性添加的方式与常规链接类相同。

标签链接

简码: [tag-link slug="category-slug"] 或 [tag-link slug="category-slug"]链接内容[/tag-link] PHP类: new WaughJ\WPTagLink\WPTagLink( $attributes );

自动生成指向标签页面的链接。使用slug获取标签。内容以及可选属性添加的方式与常规链接类相同。

媒体链接

简码: [media-link media_id=""]链接内容[/media-link] 或 [media-link media-id=""]链接内容[/media-link] 或 [media-link media-id="" value="链接内容"] PHP类: new WaughJ\WPMediaLink\WPMediaLink( $id, $content, $attributes );

自动生成媒体项目的链接。内容必须设置,否则短代码将无法工作。短代码内容也可以作为内容使用。例如,如果安装了WAJ Images,你可以使用以下常见技巧来创建图片链接:

[media-link media-id="1"][upload-image id="1"][/media-link]

安装

  1. 将插件文件上传到/wp-content/plugins/plugin-name目录,或者直接通过WordPress插件屏幕安装插件。
  2. 通过WordPress的“插件”屏幕激活插件
  3. 可以使用短代码在WordPress编辑器中添加链接,或者直接在PHP中使用类的实例。类的实例可以自动转换为字符串并用作字符串,或者你可以调用getHTML()来获取HTML代码作为字符串。

变更日志

1.0.1

  • 更新TestHashItem依赖项

1.0.1

  • 初始稳定版本。