About this plugin
This plugin includes 6 types o’ shortcodes / PHP classes:
Link
Shortcode: [link href=”url”]content[/link]
PHP Class: new WaughJ\HTMLLink\HTMLLink( $href, $content, $other_attributes );
General link where the link href given is used directly as the href. The backbone o’ all the other link types.
Content, when put ‘tween opening & closing tags, can be a shortcode o’ its own, which will be interpreted, too. When used as a PHP class, you can push any object that can be used as a string as content, including other HTML generators.
Valid attributes include all valid HTML5 attributes for the a tag, as well as…
* an “anchor” attribute that adds an anchor to the href ( the part after the # ).
first_parameter=second_value&second_parameter=second_value )
* an “external” attribute, which, when set to “true”, automatically adds HTML to make the link open in a new tab & protect it from hacking. com/alexblog/256-targetblank—the-most-underestimated-vulnerability-ever/ for mo’ info on security concerns ).
Mail-Link
[/mail-link]
PHP Class: new WaughJ\HTMLMailLink\HTMLMailLink( $email, $other_attributes );
Generates mailto link. If just email given, content automatically set to email.
Valid attributes include “value” for content ( for the direct PHP use ). all valid HTML5 attributes for the a tag, as well as the external attribute mentioned under Link.
Phone-Link
[/phone-link]
PHP Class: new WaughJ\HTMLPhoneLink\HTMLPhoneLink( $phone_number, $other_attributes );
Generates tel link. If just phone # is given, content automatically set to phone #.
Valid attributes include “value” for content ( for the direct PHP use ). all valid HTML5 attributes for the a tag, as well as the external attribute mentioned under Link.
Post-Link
Shortcode: [post-link slug=”post-slug”] or [post-link slug=”post-slug” post_type=”specific-post-type”] [post-link post_id=”post-id”]Read this post[/post-link]
PHP Class: new WaughJ\WPPostLink\WPPostLink( $attributes );
Generates a link to a post, based on slug or post_id, or, if using the PHP class, the post object itself under “post”.
In addition, you can add all the attributes you can for the regular Link class & shortcode.
Home-Link
[/home-link]
PHP Class: new WaughJ\WPHomeLink\WPHomeLink( $attributes );
Automatically generates link to WordPress front page. Content that represents link defaults to name o’ front page. All alternative attributes done the same as regular Link class & shortcode.
Category Link
Shortcode: [category-link slug=”category-slug”] or [category-link category_id=”category-id”]Link content[/category-link]
PHP Class: new WaughJ\WPCategoryLink\WPCategoryLink( $attributes );
Automatically generates link to category page. Use slug or category_id attributes to get category. Content & optional attributes added the same way as regular Link class.
Tag Link
Shortcode: [tag-link slug=”category-slug”] or [tag-link slug=”category-slug”]Link content[/tag-link]
PHP Class: new WaughJ\WPTagLink\WPTagLink( $attributes );
Automatically generates link to tag page. Use slug to get tag. Content & optional attributes added the same way as regular Link class.
Media Link
Shortcode: [media-link media_id=””]Link content[/media-link] or [media-link media-id=””]Link content[/media-link] or [media-link media-id=”” value=”Link content”]
PHP Class: new WaughJ\WPMediaLink\WPMediaLink( $id, $content, $attributes );
Automatically generates link to media item. Content must be set or shortcode won’t work. Shortcode content can be put as content, too.
For example, if WAJ Images is installed, you can do the common technique o’ an image link with:
[media-link media-id=”1″][upload-image id=”1″][/media-link]