{"id":51,"date":"2013-01-29T19:02:38","date_gmt":"2013-01-29T08:02:38","guid":{"rendered":"http:\/\/seanbdurkin.id.au\/pascaliburnus2\/?p=51"},"modified":"2013-01-30T18:43:34","modified_gmt":"2013-01-30T07:43:34","slug":"about-the-sbd-aside-plugin-for-wordpress","status":"publish","type":"post","link":"http:\/\/seanbdurkin.id.au\/pascaliburnus2\/archives\/51","title":{"rendered":"About the &#8220;SBD Aside&#8221; plugin for WordPress"},"content":{"rendered":"<aside style=\"width:200px; background-color:#DBE3A6;\" class=\"sbd-aside sbd-right sbd-round\"><header class=\"sbd-header\"><img data-recalc-dims=\"1\" loading=\"lazy\" decoding=\"async\" src=\"https:\/\/i0.wp.com\/seanbdurkin.id.au\/pascaliburnus2\/wp-content\/plugins\/sbd-aside\/expand.gif?resize=13%2C14\" width=\"13\" height=\"14\" border=\"0\"\n alt=\"Show\/Hide\" title=\"Show\/Hide\"\n onclick=\"togglePannel(this)\"\/>Open me!<\/header> <div class=\"sbd-hidden sbd-tight\"><hr class=\"sbd-swish\"\/><span class=\"sbd-content\">\n<p>This is the side-bar. You can put content here that is tangential to the main article, rather like the dramatical use of <a href=\"http:\/\/en.wikipedia.org\/wiki\/Aside\" title=\"meaning of Aside\" target=\"_blank\">asides<\/a>.<br \/>\n<\/span><\/div><\/aside>\nThe SBD Aside plugin is a WordPress plugin that allows bloggers to easily create small side-bars for there entries, called asides. <strong>I recommend against using this plugin with the WordPress Visual Editor<\/strong>, as I have not tested it with the visual editor, and will not support the use of the plugin through the Visual Editor.<\/p>\n<p>Look at the side-bar on the top right of this page. Press the pull-down button to see the content of the aside. Click the pull-up button to hide the content and make more room for the main article.<\/p>\n<h1>Features<\/h1>\n<p>Nice features of SBD Aside include:<br \/>\n<aside style=\"width:180px; background-color:#F7F72D;\" class=\"sbd-aside sbd-right sbd-sharp\"><header class=\"sbd-header\">No code traps!<\/header> <div class=\"sbd-tight\"><hr class=\"sbd-regular\"\/><span class=\"sbd-content\">\n<p>Unlike most other filter plugins, there is no content that the blogger is blocked from.<br \/>\n<\/span><\/div><\/aside>\n<ol>\n<li>HTML 5 Support. SBD Aside uses the HTML 5 semantic tag <a href=\"http:\/\/html5doctor.com\/aside-revisited\/\" title=\"Aside element\" target=\"_blank\"><code>&lt;aside&gt;<\/code><\/a> to play well with search engines and content aggregators.<\/li>\n<li>Choose left or right placement on the page.<\/li>\n<li>Choose expanded (&#8220;open&#8221;) style, or collapsible.<\/li>\n<li>collapsible ones like on the top right of this page can be collapsed or expanded by the reader as required.<\/li>\n<li>Choose round corners or square cut.<\/li>\n<li>Choose background colour.<\/li>\n<li>Choose width in pixels or percent.<\/li>\n<li>Choose from one of two caption underline styles.<\/li>\n<li>Display a caption<\/li>\n<li>All of the above options\/settings are optional. Define your own defaults in the plugin&#8217;s setting page.<\/li>\n<li>The styling for the aside is compact, with a small font and low margins. This minimises space disruption to the main article.<\/li>\n<\/ol>\n<h1>How to use<\/h1>\n<h2>Inserting an Aside<\/h2>\n<p>Its easy. Just type [aside] on the start of a line; some content; then type [\/aside] on a fresh line like so&#8230;<\/p>\n<aside style=\"width:300px; background-color:aqua;\" class=\"sbd-aside sbd-left sbd-round\"><header class=\"sbd-header\">What you get<\/header> <div class=\"sbd-tight\"><hr class=\"sbd-swish\"\/><span class=\"sbd-content\">\n<p>Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.<br \/>\n<\/span><\/div><\/aside>\n<\/p>\n<pre class=\"brush: plain; title: ; notranslate\" title=\"\">\r\n!&#x5B;aside]\r\n  caption = What you get\r\n  alignment = left\r\n  width = 300px\r\n  collapse_state = expanded\r\n  bg_colour = aqua\r\n\r\nLorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.\r\n!&#x5B;\/aside]\r\n<\/pre>\n<h2>Options<\/h2>\n<p>To specify an option put, within the [aside][\/aside] pair an option line. An option line starts with two space, and then proceeds with option=value like so&#8230;<\/p>\n<pre class=\"brush: plain; title: ; notranslate\" title=\"\">\r\n!&#x5B;aside]\r\n  caption = This is a caption\r\n!&#x5B;\/aside]\r\n<\/pre>\n<p>Available options include:<\/p>\n<table border=\"1\">\n<tr>\n<th>Option name<\/th>\n<th>Range of values<\/th>\n<th>Factory default<\/th>\n<th>Effect<\/th>\n<\/tr>\n<tr>\n<td>caption<\/td>\n<td>Any one-line text<\/td>\n<td><\/td>\n<td>The head-line for the aside<\/td>\n<\/tr>\n<tr>\n<td>alignment<\/td>\n<td>left or right<\/td>\n<td>right<\/td>\n<td>placement on the page<\/td>\n<\/tr>\n<tr>\n<td>width<\/td>\n<td>like 200px or 30%<\/td>\n<td>200px<\/td>\n<td>Width of the aside<\/td>\n<\/tr>\n<tr>\n<td>collapse_state<\/td>\n<td>expanded or collapsed<\/td>\n<td>collapsed<\/td>\n<td>Fixed-open or collapsable<\/td>\n<\/tr>\n<tr>\n<td>corners<\/td>\n<td>round or sharp<\/td>\n<td>round<\/td>\n<td>Rounded corners or square-cut<\/td>\n<\/tr>\n<tr>\n<td>hr_style<\/td>\n<td>sbd-regular or sbd-swish<\/td>\n<td>sbd-swish<\/td>\n<td>The style of the underline under the caption<\/td>\n<\/tr>\n<tr>\n<td>bg_colour<\/td>\n<td><a href=\"http:\/\/www.colorpicker.com\/\" title=\"Colour picker\" target=\"_blank\">Any html colour<\/a> like #9ae6d4<\/td>\n<td bg-color=\"#9ae6d4\">#9ae6d4<\/td>\n<td>Background colour of the aside box<\/td>\n<\/tr>\n<\/table>\n<h2>Main Aside content<\/h2>\n<p>The main aside content starts from the first line between the [aside][\/aside] that does not follow the option line pattern.<\/p>\n<h2>What about when I want to write [aside] as literal content?<\/h2>\n<p>If you want to write [aside] or [\/aside] literally then just prefix it by an exclamation mark like so&#8230;<\/p>\n<pre class=\"brush: plain; title: ; notranslate\" title=\"\">\r\n!!&#x5B;aside] is how the SBD Aside is demarcated to begin.\r\n<\/pre>\n<p>If the word &#8220;[aside] is not at the start of the line, then no problem. It does not need to be so escaped.<br \/>\nHey but what if I want to write ![aside] literally at the start of a line? If you need to write [aside] or [\/aside] literally at the start of a line, prefixed by any number of exclamation marks, just add one more exclamation mark, or just don&#8217;t put it at the start of a line. These escaping rules apply both within and external to asides.<\/p>\n<h2>Defaults for options<\/h2>\n<p>None of the options are mandatory. If absent in your blog entry text, they will take default values. The blogger can specify his own defaults through WordPress settings.<\/p>\n<h1>How to install<\/h1>\n<ol>\n<li>Your website host must have PHP version 5.3 or better. WordPress must be 3.5 or better. Check your PHP version and WordPress version.<\/li>\n<li>Deactivate any other plugin that uses the `[aside]` markup keyword.<\/li>\n<li>Upload `sbd-aside` folder and its 3 files (`sbd-aside.php`,`sbd-aside.js`,`sbd-aside.css` plus image files) to the `\/wp-content\/plugins\/` directory<\/li>\n<li>Activate the plugin through the &#8216;Plugins&#8217; menu in WordPress<\/li>\n<li>Go to the WordPress settings for SBD Aside, and configure the defaults as you prefer.<\/li>\n<\/ol>\n","protected":false},"excerpt":{"rendered":"<p>Open me! This is the side-bar. You can put content here that is tangential to the main article, rather like the dramatical use of asides. The SBD Aside plugin is a WordPress plugin that allows bloggers to easily create small &hellip; <a href=\"http:\/\/seanbdurkin.id.au\/pascaliburnus2\/archives\/51\">Continue reading <span class=\"meta-nav\">&rarr;<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"jetpack_post_was_ever_published":false,"_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"_jetpack_memberships_contains_paid_content":false,"footnotes":"","jetpack_publicize_message":"","jetpack_publicize_feature_enabled":true,"jetpack_social_post_already_shared":true,"jetpack_social_options":{"image_generator_settings":{"template":"highway","default_image_id":0,"font":"","enabled":false},"version":2}},"categories":[5],"tags":[7,6,14],"class_list":["post-51","post","type-post","status-publish","format-standard","hentry","category-wordpress","tag-aside","tag-plugin","tag-wordpress"],"jetpack_publicize_connections":[],"jetpack_featured_media_url":"","jetpack_shortlink":"https:\/\/wp.me\/p2QXbt-P","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"http:\/\/seanbdurkin.id.au\/pascaliburnus2\/wp-json\/wp\/v2\/posts\/51","targetHints":{"allow":["GET"]}}],"collection":[{"href":"http:\/\/seanbdurkin.id.au\/pascaliburnus2\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"http:\/\/seanbdurkin.id.au\/pascaliburnus2\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"http:\/\/seanbdurkin.id.au\/pascaliburnus2\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"http:\/\/seanbdurkin.id.au\/pascaliburnus2\/wp-json\/wp\/v2\/comments?post=51"}],"version-history":[{"count":45,"href":"http:\/\/seanbdurkin.id.au\/pascaliburnus2\/wp-json\/wp\/v2\/posts\/51\/revisions"}],"predecessor-version":[{"id":95,"href":"http:\/\/seanbdurkin.id.au\/pascaliburnus2\/wp-json\/wp\/v2\/posts\/51\/revisions\/95"}],"wp:attachment":[{"href":"http:\/\/seanbdurkin.id.au\/pascaliburnus2\/wp-json\/wp\/v2\/media?parent=51"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"http:\/\/seanbdurkin.id.au\/pascaliburnus2\/wp-json\/wp\/v2\/categories?post=51"},{"taxonomy":"post_tag","embeddable":true,"href":"http:\/\/seanbdurkin.id.au\/pascaliburnus2\/wp-json\/wp\/v2\/tags?post=51"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}