{"id":25805,"date":"2013-10-22T23:15:06","date_gmt":"2013-10-22T23:15:06","guid":{"rendered":"https:\/\/wordpress.org\/plugins-wp\/widget-attributes\/"},"modified":"2015-11-18T15:06:58","modified_gmt":"2015-11-18T15:06:58","slug":"widget-attributes","status":"closed","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/widget-attributes\/","author":319029,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"0.2.2","stable_tag":"0.2.2","tested":"4.4.34","requires":"3.6.1","requires_php":"","requires_plugins":"","header_name":"Widget Attributes","header_author":"Dzikri Aziz","header_description":"","assets_banners_color":"","last_updated":"2015-11-18 15:06:58","external_support_url":"","external_repository_url":"","donate_link":"http:\/\/kucrut.org\/#coffee","header_plugin_uri":"http:\/\/kucrut.org\/widget-attributes\/","header_author_uri":"http:\/\/kucrut.org\/","rating":4.7,"author_block_rating":0,"active_installs":50,"downloads":2112,"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":"1","5":"2"},"assets_icons":[],"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["0.2","0.2.1","0.2.2"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":"895067","resolution":"1","location":"assets"},"screenshot-2.png":{"filename":"screenshot-2.png","revision":"895067","resolution":"2","location":"assets"}},"screenshots":{"1":"Widget configuration form","2":"Widget attributes inserted into the markup"}},"plugin_section":[],"plugin_tags":[162],"plugin_category":[43],"plugin_contributors":[78133],"plugin_business_model":[],"class_list":["post-25805","plugin","type-plugin","status-closed","hentry","plugin_tags-widget","plugin_category-customization","plugin_contributors-kucrut","plugin_committers-kucrut"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/widget-attributes.svg","icon_2x":false,"generated":true},"screenshots":[{"src":"https:\/\/ps.w.org\/widget-attributes\/assets\/screenshot-1.png?rev=895067","caption":"Widget configuration form"},{"src":"https:\/\/ps.w.org\/widget-attributes\/assets\/screenshot-2.png?rev=895067","caption":"Widget attributes inserted into the markup"}],"raw_content":"\n

This plugin is intended to be used by theme authors that need to have custom attributes for the widgets so they can define common classes for similar widgets, etc.<\/p>\n\n

When activated, you'll get two additional input fields in the widget configuration forms, where you can assign a custom ID and classes for the widgets.<\/p>\n\n

Please note that before the attributes are saved, they will be passed through sanitize_html_class()<\/a> so all blacklisted characters will be stripped.<\/p>\n\n\n

    \n
  1. Upload widget-attributes<\/code> to the \/wp-content\/plugins\/<\/code> directory<\/li>\n
  2. Go to Plugins<\/em> and activate Widget Attributes<\/em><\/li>\n
  3. Go to Appearance<\/em> > Widgets<\/em> and add the attributes<\/li>\n<\/ol>\n\n\n
    \n
    Do I need to add code to my theme's `functions.php` file?<\/dt>\n

    No, you don't. This plugin just works(TM). However, you will need to add the style for the classes you use for your widgets.<\/p><\/dd>\n

    Is there any known bug?<\/dt>\n

    In short, maybe. If your theme or one of your plugins is replacing the default widget callback in a weird way, this plugin may not work.<\/p><\/dd>\n

    Do you provide filters?<\/dt>\n

    YES! You can hook into widget_attribute_id<\/code> and\/or widget_attribute_classes<\/code> if you need to validate\/sanitize the attributes provided by the user. For example:<\/p>\n\n

    \/**\n * Check for widget classes provided by the user\n *\n * @param string $classes Widget class(es), separated by spaces\n *\/\nfunction my_widget_classes_filter( $classes ) {\n    \/\/ do your thing...\n    return $classes;\n}\nadd_filter( 'widget_attribute_classes', 'my_widget_classes_filter' );\n<\/code><\/pre><\/dd>\n\n<\/dl>\n\n\n
    0.2.2<\/h4>\n\n