waughj / wordpress-links
WordPress插件,用于轻松生成链接。
Requires
- php: >=7.2
- waughj/html-link: >=1.2.7
- waughj/html-mail-link: >=0.1.5
- waughj/html-phone-link: >=0.1.1
- waughj/wp-category-link: >=0.1.6
- waughj/wp-home-link: >=0.1.7
- waughj/wp-media-link: >=0.2.1
- waughj/wp-post-link: >=0.2.7
- waughj/wp-tag-link: >=0.1.6
Requires (Dev)
- phpunit/phpunit: ^8.1
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]
安装
- 将插件文件上传到
/wp-content/plugins/plugin-name
目录,或者直接通过WordPress插件屏幕安装插件。 - 通过WordPress的“插件”屏幕激活插件
- 可以使用短代码在WordPress编辑器中添加链接,或者直接在PHP中使用类的实例。类的实例可以自动转换为字符串并用作字符串,或者你可以调用getHTML()来获取HTML代码作为字符串。
变更日志
1.0.1
- 更新TestHashItem依赖项
1.0.1
- 初始稳定版本。