{"id":11915,"date":"2011-01-28T19:50:20","date_gmt":"2011-01-28T19:50:20","guid":{"rendered":"https:\/\/wordpress.org\/plugins-wp\/badges\/"},"modified":"2024-05-03T11:42:24","modified_gmt":"2024-05-03T11:42:24","slug":"badges","status":"publish","type":"plugin","link":"https:\/\/twd.wordpress.org\/plugins\/badges\/","author":6463,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"2.5","stable_tag":"trunk","tested":"6.5.8","requires":"6.0","requires_php":"","requires_plugins":null,"header_name":"Display Badges","header_author":"Eug\u00e9ne Roux","header_description":"","assets_banners_color":"","last_updated":"2024-05-03 11:42:24","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/damn.org.za\/widgets\/","header_author_uri":"https:\/\/damn.org.za\/","rating":0,"author_block_rating":0,"active_installs":10,"downloads":4136,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":[],"upgrade_notice":[],"ratings":{"1":0,"2":0,"3":0,"4":0,"5":0},"assets_icons":[],"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":[],"block_files":[],"assets_screenshots":{"screenshot-2.png":{"filename":"screenshot-2.png","revision":3080910,"resolution":"2","location":"plugin"},"screenshot-1.png":{"filename":"screenshot-1.png","revision":3080910,"resolution":"1","location":"plugin"},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3080910,"resolution":"3","location":"plugin"}},"screenshots":{"1":"Configuring the widget to read badges from <code>damn-badges<\/code> and display them as \"Badges\".","2":"The default configuration of the widget, displaying the default path (badges).","3":"Badges displayed Padded and Boxed, but with Drop-Shadows disabled."},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[83,563,1779,1936,9342],"plugin_category":[],"plugin_contributors":[85574],"plugin_business_model":[],"class_list":["post-11915","plugin","type-plugin","status-publish","hentry","plugin_tags-admin","plugin_tags-administration","plugin_tags-books","plugin_tags-read","plugin_tags-reading","plugin_contributors-eroux","plugin_committers-eroux"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/badges.svg","icon_2x":false,"generated":true},"screenshots":[{"src":"https:\/\/ps.w.org\/badges\/trunk\/screenshot-1.png?rev=3080910","caption":"Configuring the widget to read badges from <code>damn-badges<\/code> and display them as \"Badges\"."},{"src":"https:\/\/ps.w.org\/badges\/trunk\/screenshot-2.png?rev=3080910","caption":"The default configuration of the widget, displaying the default path (badges)."},{"src":"https:\/\/ps.w.org\/badges\/trunk\/screenshot-3.png?rev=3080910","caption":"Badges displayed Padded and Boxed, but with Drop-Shadows disabled."}],"raw_content":"<!--section=description-->\n<p>Display \"Badges\" (which are really no more than HTML snippets) from a set of files in a specified directory off the root of the blog. The directory will default to \".\/badges\" and the Zip file contains both that directory as well as a \"Sample\" badge.<\/p>\n\n<p>Using the Widget you can choose whether to:<\/p>\n\n<ol>\n<li>enable \"Display Badge in a Box\" (enabled by default, uses internal CSS)<\/li>\n<li>enable \"Display a Drop-Shadow\" (probably best used with \"Box Mode\")<\/li>\n<\/ol>\n\n<p>as well as<\/p>\n\n<ol>\n<li>decide whether you would like to use a Title<\/li>\n<li>define the directory of the badges.<\/li>\n<\/ol>\n\n<!--section=installation-->\n<p><strong>Install<\/strong><\/p>\n\n<ol>\n<li>Unzip the <code>badges.zip<\/code> file.<\/li>\n<li>Upload <code>badges.php<\/code> to the <code>\/wp-content\/plugins\/<\/code> directory.<\/li>\n<li>Activate the plugin through the 'Plugins' menu in WordPress.<\/li>\n<li>Use the \"Badges\" widget.<\/li>\n<\/ol>\n\n<p><strong>Upgrade<\/strong><\/p>\n\n<ol>\n<li>Follow your normal installation process<\/li>\n<li>Open the Widget Control Panel for \"Badges\" and confirm settings.<\/li>\n<li>Sit back and enjoy...<\/li>\n<\/ol>\n\n<p><strong>Use the WordPress Plug-in System<\/strong><\/p>\n\n<ol>\n<li>Select \"Upgrade and Activate\"<\/li>\n<li>Congratulate yourself on a sterling job.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id='which%20naming%20convention%20is%20used%20for%20the%20badges'><h3>Which naming convention is used for the badges<\/h3><\/dt>\n<dd><p>All badges needs to be named <code>XXname.inc<\/code>, where \"XX\" is a number (used to determine ordering) and the \".inc\" is required.<\/p><\/dd>\n<dt id='what%20is%20the%20format%20of%20the%20%22badge%22%20files%3F'><h3>What is the format of the \"Badge\" files?<\/h3><\/dt>\n<dd><p>You could view the included \"demo\" file: <code>00testbadge.inc<\/code>, but here's another, slightly simpler, example:<\/p>\n\n<pre><code>&lt;!-- Support CC --&gt;\n&lt;div id=\"badge-supportcc-inner\" onclick=\"location.href='http:\/\/creativecommons.org';\" style=\"cursor: pointer;\"&gt;\n&lt;img width=88 height=31 alt=\"http:\/\/creativecommons.org\" title=\"Support the Creative Commons!\"\n    src=\"http:\/\/creativecommons.org\/images\/support\/2010\/cc-support.png\" \/&gt;\n&lt;br \/&gt;\n    Support the Creative Commons!\n&lt;\/div&gt;\n&lt;!-- \/Support CC --&gt;\n<\/code><\/pre><\/dd>\n<dt id='how%20do%20i%20style%20the%20badges%20using%20css%3F'><h3>How do I style the badges using CSS?<\/h3><\/dt>\n<dd><p>Quite simply by using the <code>div.badgegroup<\/code> class to style a set of badges. To style them individually, use the <code>div.badge<\/code> class.<\/p><\/dd>\n<dt id='how%20do%20i%20limit%20the%20styling%20to%20a%20set%20of%20badges%3F'><h3>How do I limit the styling to a set of badges?<\/h3><\/dt>\n<dd><p>Look for the relevant \"Badge Group's\" ID and then use the <code>div#badge-ID &gt; div.badge<\/code> CSS selector.<\/p><\/dd>\n<dt id='how%20do%20i%20style%20a%20single%20badge%3F'><h3>How do I style a single badge?<\/h3><\/dt>\n<dd><p>Easiest yet: every badge gets a unique ID generated by the plug-in based on the badge's file-name and the directory. Simply use that (you'll have to inspect the source to see what the id is; by example the ID generated by my Site-Licence badge is \"badge-damn-licencing-licencing\").<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>2.3<\/h4>\n\n<ul>\n<li>Give groupings of badges a different class than badges<\/li>\n<\/ul>\n\n<h4>2.2<\/h4>\n\n<ul>\n<li>Moved to a '&lt;div&gt;' based layout instead of using Lists<\/li>\n<li>Split Boxing and Padding into two separate options<\/li>\n<\/ul>\n\n<h4>2.1<\/h4>\n\n<ul>\n<li>Fixed the HTML generated to be cleaner and identify the badge class better<\/li>\n<li>Simplified the examples slightly<\/li>\n<\/ul>\n\n<h4>2.0<\/h4>\n\n<ul>\n<li>Cosmetic changes<\/li>\n<li>Added (better) examples to the documentation<\/li>\n<\/ul>\n\n<h4>1.0<\/h4>\n\n<ul>\n<li>Initial Public Release<\/li>\n<\/ul>","raw_excerpt":"Display a set of badges based on files in a directory off the root of the blog.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/11915","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=11915"}],"author":[{"embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/eroux"}],"wp:attachment":[{"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=11915"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=11915"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=11915"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=11915"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=11915"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=11915"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}