kucrut

Minimize KDE IM Contacts to System Tray

Dzikri Aziz — Wed, 13 Feb 2013 21:50:51 +0000

It bothers me that KDE IM Contacts logs you out when you close the main window, and there’s no GUI to change this behavior. The “fix” is simple, just edit ~/.kde/share/config/ktp-contactlistrc and change go_offline_when_closing value to false:

[General]
go_offline_when_closing=false

Source: KDE Forums

KC Settings Data

Dzikri Aziz — Sat, 09 Jun 2012 19:30:57 +0000

Just a quick note to those of you using KC Settings. As of version 2.6.8, all variables in kcSettings class have been merged and set to private. So if you’ve previously used kcSettings::$data, you will need to change your code to use the available method: kcSettings::get_data(). This static method behaves exactly like kc_get_option(), so you can put as many arguments (the array keys) as you like there to get the data you need, for example:

kcSettings::get_data('settings', 'plugin', 'myprefix', 'mysection')

Add HTML Tags in Post and Widget Titles

Dzikri Aziz — Thu, 03 May 2012 11:49:46 +0000

In a recent project, I needed to use tags to add some styles (just color, actually) to post and widget titles. By default — and there’s no hook to disable this — WordPress strips any HTML tags found in post and widget titles. Here’s my solution to this problem. Please keep in mind that I only needed to add tags, so if you need to add more tags, you should modify the code to fit your needs :)

First, add the span tags to the desired post and widget titles, replacing the < and > characters with hashes ( # ):

Add fake span tags to post and widget titles

Now, let’s create a tiny mu-plugin to handle our HTML tags. We’ll be using four filter hooks for this:

the_title, triggered in post titles
the_title_rss, triggered in post titles for feeds
wp_title, triggered in HTML document title, and
widget_title, triggered in — well, you guessed it right — widget titles

The plugin:

$replace = ( in_array($filter, array('wp_title', 'the_title_rss')) || ($filter == 'the_title' && (is_admin() || in_array('wp_head', $wp_current_filter))) ) ? '' : array('', '');
  $string = str_replace( $search, $replace, $string );

  return $string;
}

add_filter( 'the_title', 'kc_convert_title_html_tags' );
add_filter( 'the_title_rss', 'kc_convert_title_html_tags' );
add_filter( 'wp_title', 'kc_convert_title_html_tags' );
add_filter( 'widget_title', 'kc_convert_title_html_tags' );

?>

Take a closer look to the replacement string. We need to strip our fake HTML tags from the post titles when:

kc_convert_title_html_tags() is called by wp_title or the_title_rss hook
the_title filter hook is triggered from within wp_head action hook (eg. the post title is used by the title attribute of feed links
we’re viewing a post table in admin area.

However, when we’re inside the , they need to be converted to the real tags.

That’s it! :)

3 Jagoan Internet

Dzikri Aziz — Tue, 06 Mar 2012 11:05:37 +0000

Ternyata slogannya emang asli banget, ga ngecewain. Kuenceng, murah, stabil! Dengan modem pas-pasan dan sinyal paling tinggi 40%, gw bisa dapet segini nih:

wp_list_pages() for Custom Post Types

Dzikri Aziz — Sat, 18 Feb 2012 20:34:26 +0000

wp_list_pages() is a handy little function for displaying a list of hierarchical post type, and it works with custom post types too. Unfortunately, when used for a custom post type, the list items don’t have the necessary CSS classes for current page item/ancestors. Here’s a quick fix for this particular problem.

function kct_page_css_class( $css_class, $page, $depth, $args ) {
  if ( empty($args['post_type']) || !is_singular($args['post_type']) )
    return $css_class;

  $_current_page = get_queried_object();

  if ( in_array( $page->ID, $_current_page->ancestors ) )
    $css_class[] = 'current_page_ancestor';
  if ( $page->ID == $_current_page->ID )
    $css_class[] = 'current_page_item';
  elseif ( $_current_page && $page->ID == $_current_page->post_parent )
    $css_class[] = 'current_page_parent';

  return $css_class;
}
add_filter( 'page_css_class', 'kct_page_css_class', 10, 4 );

Override max-width

Dzikri Aziz — Tue, 14 Feb 2012 11:20:30 +0000

Just use none :)

.hentry img {height:auto; max-width:100%}
.hentry .someclass img {max-width:none}

KC DropBox

Dzikri Aziz — Mon, 06 Feb 2012 13:57:47 +0000

Here’s a simple plugin for uploading files from your WordPress site front-end. It uses Jaka Jancar’s DropBox Uploader and inspired by a tutorial on WP Tuts+ (although I took a slightly different approach). It’s pretty easy to use and you can integrate it in your contact forms.

Clone/download it from GitHub and feel free to let me know if you have any problem.

PulseAudio Equalizer

Dzikri Aziz — Tue, 31 Jan 2012 08:26:47 +0000

Finally got PulseAudio’s equalizer working. It consumes 1-4% of my 2.30GHz i5 CPU (Clementine’s built-in equalizer consumes 4-7%, btw), and sounds really good :)

In Gentoo, all you need to do to get this working is to install pulseaudio with equalizer USE-flag enabled (may need to unmask the unstable ebuild) and append this line to /etc/pulse/default.pa or ~/.pulse/default.pa (you can change the sink name to your liking) :

load-module module-equalizer-sink sink_name=equalized

After that, quit all applications that use pulseadio and restart pulseaudio:

pulseaudio --kill && pulseaudio --start

Now you should be able to use the equalized sink name for your multimedia application. For example, in Clementine, go to Tools » Preferences » Playback and change the Output plugin to PulseAudio Sink and fill the Output device field with your equalized sink name (equalized in the above example).

While Clementine’s playing, adjust the equalizer levels by running qpaeq. All done! ;-)

KDE 4.8 Taskbar

Dzikri Aziz — Mon, 30 Jan 2012 12:46:43 +0000

I’m not really sure if this feature is part of KDE SC 4.8, but it’s so cool and I feel like I have to write about it here :)

See the screenshot above? KDE’s default taskbar is now more powerful than ever! Right clicking on a taskbar item now gives you the ability to start a new instance of that application, and add a launcher of that application to the taskbar when it’s not running.

I know, it’s pretty similar to what Windows 7 offers, except (IMO) it’s waay cooler. In Windows 7, if you pinned an application to the taskbar, it will only show an icon, without the application name/window title, no matter the state of the application is (running or not). In KDE, well, you guessed it, if the application is not currently running, an icon will be added to the taskbar, and it will disappear when it’s launched.

If you really want Windows 7′s taskbar in KDE, you can install this plugin :)

Using Built-in Post Finder in Plugins

Dzikri Aziz — Fri, 20 Jan 2012 00:54:23 +0000

I was making some improvements to the KC Posts widget module in my KC Essentials plugin, and I wanted to make it easy for the users to find post IDs they want to include/exclude from the query. As you may already know, in the Media admin page, we can ‘attach’ an attachment to a post. It uses a neat jQuery UI dialog box to find posts. Here’s how I use it in KC Essentials.

First add we need to add the dialog box and the required JS to the admin page, in my case, it’s widgets.php.

add_action( 'load-widgets.php', 'my_widgets_admin_actions' );
function my_widgets_admin_actions() {
  # Enqueue scripts
  wp_enqueue_script( 'my-widgets-admin-scripts', plugins_url('myscript.js', __FILE__), array('media', 'wp-ajax-response'), '0.1', true );

  # Add the finder dialog box
  add_action( 'admin_footer', 'find_posts_div', 99 );
}

Next, create myscript.js file inside the plugin directory and add these lines:

jQuery(document).ready(function($) {
  // Find posts
  var $findBox = $('#find-posts'),
      $found   = $('#find-posts-response'),
      $findBoxSubmit = $('#find-posts-submit');

  // Open
  $('input.kc-find-post').live('dblclick', function() {
    $findBox.data('kcTarget', $(this));
    findPosts.open();
  });

  // Insert
  $findBoxSubmit.click(function(e) {
    e.preventDefault();

    // Be nice!
    if ( !$findBox.data('kcTarget') )
      return;

    var $selected = $found.find('input:checked');
    if ( !$selected.length )
      return false;

    var $target = $findBox.data('kcTarget'),
        current = $target.val(),
        current = current === '' ? [] : current.split(','),
        newID   = $selected.val();

    if ( $.inArray(newID, current) < 0 ) {
      current.push(newID);
      $target.val( current.join(',') );
    }
  });

  // Double click on the radios
  $('input[name="found_post_id"]', $findBox).live('dblclick', function() {
    $findBoxSubmit.trigger('click');
  });

  // Close
  $( '#find-posts-close' ).click(function() {
    $findBox.removeData('kcTarget');
  });
});

A quick explanation:
When the user double-clicks the input.kc-find-post field, the finder dialog box will popup. Clicking the Select button will send the selected post's ID to the input field. This can also be done by double-clicking one of the radio inputs at the left side of each found posts.

Need a demo? Just install KC Essentials :)

Move Cursor to the Next/Previous Paragraph in Kate

Dzikri Aziz — Fri, 20 Jan 2012 00:05:53 +0000

It kind of irritates me that Kate doesn’t have a builtin functionality to move cursor to the next/previous paragraph. Fortunately, as with most KDE SC applications, Kate is extendable with custom scripts. So here’s my solution for the mentioned problem.

/* kate-script
 * author: Dzikri Aziz 
 * license: GPLv2
 * revision: 3
 * kate-version: 3.4
 * type: commands
 * functions: jumpUp, jumpDown
 *
 * Move cursor to next/previous paragraph
 */

function jumpDown() {
  return _jump();
}


function jumpUp() {
  return _jump( true );
}


function action( cmd ) {
  var a = new Object();
  if ( cmd == 'jumpUp' ) {
    a.text = i18n('Move cursor to previous paragraph');
    a.shortcut = 'Alt+Up';
    a.icon = "";
    a.category = "";
    a.interactive = false;
  }
  else if ( cmd == 'jumpDown' ) {
    a.text = i18n('Move cursor to next paragraph');
    a.shortcut = 'Alt+Down';
    a.icon = "";
    a.category = "";
    a.interactive = false;
  }

  return a;
}


function help( cmd ) {
  if (cmd == 'jumpUp') {
    return i18n('Move cursor to previous paragraph');
  }
  else if (cmd == 'jumpDown') {
    return i18n('Move cursor to next paragraph');
  }
}


function _jump( up ) {
  var init   = curPos = view.cursorPosition().line,
      lines  = document.lines(),
      target;

  if ( document.firstColumn(curPos) == -1 )
    curPos = document.prevNonEmptyLine(curPos);

  if ( up === true ) {
    target = 0;
    while ( curPos-- > 0 ) {
      if ( document.firstColumn(curPos) == -1 && document.nextNonEmptyLine(curPos) != init ) {
        target = document.nextNonEmptyLine(curPos);
        break;
      }
    }
  }

  else {
    lines--;
    target = lines;
    while ( curPos++ < lines ) {
      if ( document.firstColumn(curPos) == -1 && document.nextNonEmptyLine(curPos) != init ) {
        target = document.nextNonEmptyLine(curPos);
        break;
      }
    }
  }

  view.setCursorPosition(target, 0);
}

Save this script as jump.js inside katepart directory in your KDE user directory, eg: $KDEHOME/share/apps/katepart/script (just create the sub-directories if they don't exist yet) and relaunch Kate. Now you can move the cursor to the next paragraph by pressing Alt+Up or the previous one by pressing Alt+Down. You can freely customize the shortcut from Settings » Configure Shortcuts.

Any improvements are welcome!

As a bonus, here's the scripting guide I printed from Google cache.

jQuery in Widgets Admin Page

Dzikri Aziz — Tue, 17 Jan 2012 20:31:15 +0000

Here’s a quick tip. If you built a custom widget for your themes/plugins and you need jQuery for the configuration form, you’ll need to call it when the ajax process is done, that is when a widget was just dropped to a sidebar/widget area, or the user just saved the configuration.

jQuery(document).ready(function($) {
  $('.widgets-sortables').ajaxSuccess(function() {
    // do your thing
  });
});

Hacking Term List Table

Dzikri Aziz — Wed, 11 Jan 2012 13:33:57 +0000

Term list table, unlike post list table, is not very customizable. What I needed was to display the thumbnail/icon of each term, to make it easier for the content editors to distinguish one term from another.

I consider this as a hack, not because we’re going to edit a core file (never ever do that, please!), but because we’re (ab)using a filter hook to display the thumbnail, which should normally be done through an action hook. Unfortunately, if we take a look at wp-admin/includes/class-wp-terms-list-table.php file, there’s only one action hook in there, which can’t help us. However, there’s a filter hook that can be useful for our situation: "{$taxonomy}_row_actions", normally used to customize the action links that show up when we hover over a term row.

Before we begin, We need to decide how we attach an image to a term. There are many plugins out there that can help us with this, but in this guide we’ll be using my own plugin, KC Settings. By the way, if the plugin of your choice doesn’t use termmeta table to store terms metadata, I strongly suggest you to look for another plugin :)

Let’s get started with creating a mu-plugin file, or editing a our theme’s function.php file (not recommended). We’ll be using the category taxonomy throughout this guide, but you can off course use other taxonomies.

First we’ll add an entry for KC Settings, (please refer to the sample files included in the plugin to learn about the setting array), or you can also use the Builder if you like.

function my_category_metadata( $groups ) {
  $groups[] = array(
    'category' => array(
      array(
        'id'        => 'category-meta',
        'title'     => 'Metadata',
        'fields'    => array(
          array(
            'id'    => 'icon',
            'title' => 'Icon',
            'type'  => 'file'
          )
        )
      )
    )
  );

  return $groups;
}
add_filter( 'kc_term_settings', 'my_category_metadata' );

Now we can attach an image when creating/editing a term:

Attach/set term icon

To get the data, we can use get_term_meta(). For example, assuming the category ID is 20:

print_r( get_metadata('term', 20, 'icon', true) );

…which outputs:

Array
(
  [selected] => Array
    (
      [0] => 38
    )
  [files] => Array
    (
      [0] => 38
    )
)

Next, we’ll display each term’s icon on the term list table:

function my_category_column_hack( $actions, $term ) {
  if ( $icon = get_metadata('term', $term->term_id, 'icon', true) ) {
    if ( isset($icon['selected'][0]) && $img = wp_get_attachment_image( $icon['selected'][0]) )
      echo ''.$img.'';
  }

  return $actions;
}
add_filter( 'category_row_actions', 'my_category_column_hack', 10, 2 );

We’re basically done, and the term table should now display the icons of each term. However, we need to add some CSS to make it look a little bit sexier and to match the Media screen.

function my_admin_inline_styles() {
  $screen = get_current_screen();
  if ( $screen->base == 'edit-tags' ) { ?>

Setting Default File Permission in Linux™

Dzikri Aziz — Sun, 08 Jan 2012 13:18:52 +0000

Here’s the situation; I want every newly created file/directory in /var/www to be owned by user kucrut and group apache, and they should have read/write permissions, while all other users/groups should only have read permission. We will use ACL for this, and it’s usually installed by default.

First, we need to make sure that the partition which the /var/www directory resides (usually /has ACL enabled. The /etc/fstab line should look like this:

# Partition  # Mount point   # Filesystem     # Options         # Dump/pass
/dev/sda5    /               ext4             noatime,acl       0 1

If acl isn’t there yet, add it, save the file, and remount the partition by running this command as root (or use sudo):

mount -o remount /

If you can’t remount the partition for whatever reason, just reboot :)

Now run this set of commands as root, and don’t forget to change kucrut and apache to the desired username and group respectively:

# Set ownership
chown -R kucrut:apache /var/www

# Set permission
chmod -R g+ws /var/www

# Set default permission for newly created files/directories
setfacl -R -d -m g::rwx /var/www
setfacl -R -d -m o::rx /var/www

… and we’re done.

Try creating a new file and check its permission:

touch /var/www/xyz && ls -l /var/www/xyz
-rw-rw-r-- 1 kucrut apache 0 2012-01-08 /var/www/xyz

Source: LinuxQuestions.org

Midori

Dzikri Aziz — Sat, 07 Jan 2012 17:40:36 +0000

Did you know that Midori is way ahead of Chrom(e|ium) (and Firefox for that matter), and just slightly behind Opera in term of HTML5 input types support?

Add Panel to Debug Bar

Dzikri Aziz — Fri, 06 Jan 2012 13:02:27 +0000

We all have WP_DEBUG enabled and use Debug Bar when developing WordPress plugins and themes, right? Here’s how I added my own panel.

class myDebugPanel {
  function title() {
    return 'My Debug';
  }

  function prerender() {}

  function is_visible() {
    return true;
  }

  function render() {
    echo 'Panel content....';
  }
}

The class should be easy to understand, and don’t remove the prerender() method, it’s needed by Debug Bar when adding our panel.

Next, we’ll inject our new panel into Debug Bar panels collection, and we’re done.

function my_debug_panel_insert( $panels ) {
  $panels[] = new myDebugPanel;
  return $panels;
}
add_filter( 'debug_bar_panels', 'my_debug_panel_insert' );

Customize post type archive order

Dzikri Aziz — Tue, 03 Jan 2012 13:42:15 +0000

By now you’re probably already familiar with one of WordPress’ most loved features, custom post type. A custom post type could be hierarchical (like page) or non-hierarchical (like post). This snippet will modify the default posts order when the post type archive is being displayed.

Note:
Instead of adding these snippets into your theme’s functions.php file, I really recommend creating a mu-plugin file, so you will always get the functionality, no matter what theme you’re currently using (IMO, themes shouldn’t interfere with this kind of functionality anyway).

Register Post Type

For this to work, there are three things we need to pay attention to when registering our post type; it has to be set to hierarchical, it has to support page-attributes, and it has to support archive.

function my_custom_post_types_register() {
  register_post_type('work', array(
    'labels'        => array('name' => __('Works'), 'singular_name' => __('Work')),
    'public'        => true,
    'hierarchical'  => true,
    'supports'      => array('title', 'editor', 'thumbnail', 'page-attributes'),
    'has_archive'   => true,
    'rewrite'       => array('slug' => 'work', 'with_front' => false)
  ));
}
add_action( 'init', 'my_custom_post_types_register' );

Customize archive order

function my_custom_archive_order( $vars ) {
  if ( !is_admin() && isset($vars['post_type']) && is_post_type_hierarchical($vars['post_type']) ) {
    $vars['orderby'] = 'menu_order';
    $vars['order'] = 'ASC';
  }

  return $vars;
}
add_filter( 'request', 'my_custom_archive_order');

The code should be pretty self-explanatory; we will only modify the order if we’re on the front-end, and we’re viewing a hierarchical post type archive.

Actually, the hierarchical mode is not really needed for this, since custom-ordering posts can always be done if the post type supports page-attributes. However, IMO, custom order doesn’t really make sense for non-hierarchical posts, don’t you think? :)

If you don’t want to set the post type to hierarchical, just replace the third logic in my_custom_archive_order, so it would check if the post type supports page-attributes:

if ( !is_admin() && isset($vars['post_type']) && post_type_supports($vars['post_type'], 'page-attributes') ) {
//...

To reorder the posts, you can manually edit their orders one by one, or use this plugin (only if you don’t have/need child pages, since it doesn’t support it yet).

Example? Try this :)

RMS

Dzikri Aziz — Tue, 03 Jan 2012 02:42:53 +0000

Richard Stallman Was Right All Along

Reminder: Laptop Mode Tools for 3.1.x kernels

Dzikri Aziz — Fri, 30 Dec 2011 13:19:12 +0000

If laptop mode tools service won’t start and you’re running a 3.1.x kernel, just add the kernel version in /usr/sbin/laptop_mode line ~ 500, so it should look:

case "$KLEVEL" in
        "2.4" ) ;;
        "2.6" ) ;;
        "3.0" ) ;;
        "3.1" ) ;;

Don’t forget to check the file after every updates.

Source: Gentoo Forums

Smart Firefox

Dzikri Aziz — Fri, 30 Dec 2011 13:09:08 +0000

I just love the fact that Firefox remembers the directory/folder you last used to save a downloaded file from a particular site. Just select Always ask me where to save files in Preference » General » Downloads and you’re set.

NOT in that thing called Chrom(e|ium) :P

WordPress Theme: Polos

Dzikri Aziz — Thu, 29 Dec 2011 03:52:52 +0000

So, I kinda needed a new theme for this blog and I wanted it to be minimalist, no-nonsense :D

If you like it, you can use it too! Download it from GitHub (for now). I’ve submitted it to the WordPress themes official repo, and once it’s up, I’ll update this post.

Found a bug or got any suggestions, feel free to leave your comments below.

Update:
OH: I forgot, this theme won’t work on IE < 9 :P

Update #2:
The theme is now available at WP Extend

Enjoy! :)

Separate Comments and Pings (Trackbacks/Pingbacks)

Dzikri Aziz — Tue, 27 Dec 2011 10:30:40 +0000

When building this new theme I’m using here at kucrut.org, I wanted to separate the comments from pings. Not just give them a different style and content, but completely separate the lists. So here’s my solution, which is heavily based on the Toolbox theme.

Comments template

First, we need to create a comments.php template for our theme.

The code says:

If password is required for this post, show a message, and stop.
If this post have comments (all types), list them.
If discussion is closed, or it’s a page, or the post type doesn’t support comments, show a message.
Display a comment form (when applicable)

kct_response_list() is the function that will do the listing so we will add it to our theme’s functions.php file. This function depend on three other functions:

kct_get_comments_count(); checks if the current post have comments with specified type,
kct_comment_list(); lists comments, and
kct_pings_list(); lists pings.

We can even separate trackbacks and pingbacks, but I don’t think it’s necessary. The generated markup is simple but flexible enough, in case we want to create tabs for switching between comments and pings. Also, there are some handy hooks in there, in case we’d like to inject/do something interesting.

So, here are the functions, hope it will be useful for your projects.

Get comments count

function kct_get_comments_count( $post_id = 0, $type = '' ) {
  return count(get_comments(array(
    'post_id' => $post_id,
    'status'  => 'approve',
    'type'    => $type
  )));
}

List Comments

function kct_comment_list( $comment, $args, $depth ) {
  $GLOBALS['comment'] = $comment; ?>
   id="li-comment-">
    
      
        
          
          
        

        
          
           $depth,
            'max_depth'    => $args['max_depth'],
            'before'        => ' – ',
            'after'            => ''
          )) ); ?>
          
        
      

      
        comment_approved == '0' )
            echo ''.__('Your comment is awaiting moderation.').'';
          comment_text();
        ?>
      
    
  
List pings
function kct_pings_list( $comment, $args, $depth ) {
  $GLOBALS['comment'] = $comment; ?>
   id="li-comment-">

List all responses (comments and pings)
function kct_response_list( $post_id = 0 ) {
  foreach ( array('comment' => __('Comments'), 'pings' => __('Pings')) as $type => $title ) {
    if ( !kct_get_comments_count($post_id, $type) )
      continue; ?>
  
  

  
     "kct_{$type}_list", 'type' => $type) ); ?>

KC Settings 2.0

Dzikri Aziz — Sat, 22 Oct 2011 10:20:53 +0000

I just realeased version 2.0 of my KC Settings plugin a few hours ago. This release brings many bug fixes, improvements, and some cool new features.

The most important new feature in this release is KC Settings Builder. Now, you don’t need to create your settings manually by writing long arrays. Instead, just go to KC Settings menu under the Settings menu in your WordPress admin dashboard add create your settings there. I’ve tested this tool over and over to make sure there’s no bug left in it. But, if you think you find any, don’t hesitate to report it here, or the WP.org Support forum with tag kc-settings.

The other important new feature is the file field type. With this type, you can upload as much files as you want, and you can use them in your posts (multiple thumbnails, slideshow, etc), user metadata (custom local avatar), term metadata (term/category icon), or even plugin/theme (site logo, background, etc). All files that you uploaded are tracked by WordPress as usual (attachment post type), so you can also use them in your posts/pages, etc.

There are still quite a few features that I’d like add to this plugin, like using metaboxes for the theme/plugin setting page, more field types, etc, so if you have a brilliant idea that you need to be included in this plugin, feel free to let me know.

KC Media Enhancements

Dzikri Aziz — Sun, 10 Apr 2011 21:53:03 +0000

Not so long ago I’ve blogged about adding some enhancements to WordPress media management, such as inserting images with custom sizes into post and setting terms for the attachments along with individual plugins for each functionality. When I released the KC Widget Enhancements plugin, I thought I should combine those plugins into one package too. So now I present it: KC Media Enhancements.

Update
The plugin is now hosted at WordPress Plugin repo. Enjoy :)

This plugin currently provides you with the two functionalities mentioned above which you can enable/disable easily if you have KC Settings plugin installed. You can also modify the options using the available kcme_options filter (please read the FAQ section in the readme.txt file on how to do this).

The plugin is currently hosted at GitHub and will always be updated there, but it’s also in the process of approval to be hosted at WordPress plugin repo and I will update this post as soon as it’s approved and hosted there.

Enjoy the plugin and feel free to leave a comment/bug report/ideas in the comments section below :)

KC Widget Enhancements

Dzikri Aziz — Tue, 05 Apr 2011 19:15:53 +0000

As I promised when I wrote the functions for adding custom classes for WordPress widgets, I’m now announcing the release of KC Widget Enhancements. This plugin provides the ability to set custom classes and ID for any widgets, not just the built-in ones, but also widgets that comes with installed plugins/themes.

Update:
This plugin is now hosted at WordPress plugin repo so you can install it directly from the admin dashboard.

Currently there are three components, but I designed this plugin to be extendable so it should be easy to add more in the future:

Custom widget ID
Custom widget classes
Enable shortcode on text widgets

If you have idea on how to enhance the widgets even more, please don’t hesitate to leave a comment below. I may add them in the next versions.

To get the most of this plugin, I highly suggest the use of KC Settings together with this plugin so you can enable/disable the components easily. Or if you prefer to do it the geeky way, please read FAQ section in the readme.txt file.

You can download this plugin from here or clone/fork it from github. I’ll update this post when it’s available on WordPress’ plugins repo.

Notes:
As reported by Ed Nailor, the custom ID/classes won’t get printed if you’re using Widget Logic plugin, because it overrides the default callback for each widget.

Remove Protected Post Title Prefix

Dzikri Aziz — Sat, 26 Mar 2011 17:36:05 +0000

By default, WordPress will prefix protected post’s title with Protected. This is good when the password hasn’t been supplied. Unfortunately, it doesn’t remove this prefix when the correct password has been supplied which is not good IMO. Here’s a snippet to ‘fix’ this behavior:

function kc_protected_title_format( $format ) {
	if ( !post_password_required() )
		$format = '%s';

	return $format;
}
add_filter( 'protected_title_format', 'kc_protected_title_format' );

Reminder: add_action

Dzikri Aziz — Fri, 11 Mar 2011 13:08:38 +0000

Just a quick reminder, when dynamically adding an action inside an action callback for the same hook, don’t forget to use lower priority for the action you just added.

add_action( 'init', 'my_fuction' );
function my_fuction( $args ) {
    // ...
    add_action( 'init', 'my_other_function', 11 );
}

Insert Image with Custom Size into Post

Dzikri Aziz — Fri, 25 Feb 2011 12:21:09 +0000

Since version 2.9, WordPress provided a new function, add_image_size() to define additional image sizes along with the three default sizes: Thumbnail, Medium and Large. After defining the additional sizes, we can use them in our themes either using the_post_thumbnail(), wp_get_attachment_image(), or any other functions that suit your needs.

Update
I’ve created a plugin for this so you won’t need to edit your theme/plugin files anymore :) Download it from WordPress plugins repo.

function my_insert_custom_image_sizes( $sizes ) {
  global $_wp_additional_image_sizes;
  if ( empty($_wp_additional_image_sizes) )
    return $sizes;

  foreach ( $_wp_additional_image_sizes as $id => $data ) {
    if ( !isset($sizes[$id]) )
      $sizes[$id] = ucfirst( str_replace( '-', ' ', $id ) );
  }

  return $sizes;
}
add_filter( 'image_size_names_choose', 'my_insert_custom_image_sizes' );

The result

Note: The new code is adapted from here.

Unique post category/term

Dzikri Aziz — Mon, 21 Feb 2011 22:26:45 +0000

In WordPress, we can set multiple categories/terms for a post. This is true for both hierarchical taxonomies (ex: category) and non-hierarchical taxonomies (ex: post_tag). However, on a project I’ve worked on, the client wanted me to make the category metabox to use radio inputs (exactly like WordPress’ new post format feature) instead of checkboxes to prevent the editor from setting multiple categories for the post (s)he writes. This request forced me :) to come up with a solution. I was also inspired by Justin Tadlock’s idea on using a taxonomy for theme layout. Here’s my solution in hope it could be useful for others.

The result

Unique Taxonomy Metabox

The code

As usual, you can either add this code to your theme’s function.php file or create a new php file for it and place it inside wp-content/mu-plugins directory (preferred) so you can always have this feature no matter what theme you’re using.

hierarchical || !$taxonomy->show_ui || empty($taxonomy->object_type) )
			continue;

		foreach ( $taxonomy->object_type as $pt ) {
			# Remove default metabox
			remove_meta_box( "{$tax_name}div", $pt, 'side' );

			# Add our own
			add_meta_box( "unique-{$tax_name}-div", $taxonomy->labels->singular_name, 'kc_unique_taxonomies_metabox', $pt, 'side', 'low', array('taxonomy' => $tax_name) );
		}
	}
}
add_action( 'admin_menu', 'kc_unique_taxonomies' );


function kc_terms_radiolist( $post_id, $taxonomy, $echo = true ) {
	$terms = get_terms( $taxonomy, array('hide_empty' => false) );
	if ( empty($terms) )
		return;
	$name = ( $taxonomy == 'category' ) ? 'post_category' : "tax_input[{$taxonomy}]";

	$post_terms = get_the_terms( $post_id, $taxonomy );
	$nu_post_terms = array();
	if ( !empty($post_terms) ) {
		foreach ( $post_terms as $post_term )
			$nu_post_terms[] = $post_term->term_id;
	}

	$output = '';
	foreach ( $terms as $term ) {
		$output .= "";
		$output .= "";
		$output .= "term_id, $nu_post_terms), true, false )."/>";
		$output .= " {$term->name}";
		$output .= "\n";
	}

	if ( $echo )
		echo $output;
	else
		return $output;
}

function kc_unique_taxonomies_metabox( $post, $box ) {
	if ( !isset($box['args']) || !is_array($box['args']) )
		$args = array();
	else
		$args = $box['args'];

	$defaults = array('taxonomy' => 'category');
	extract( wp_parse_args($args, $defaults), EXTR_SKIP );
	$tax = get_taxonomy($taxonomy);

	?>
	
		"; // Allows for an empty term set to be sent. 0 is an invalid Term ID and will be ignored by empty() checks.
		?>
		
			ID, $taxonomy ) ?>
		
	cap->assign_terms) ) { ?>
		
	
	cap->edit_terms) ) { ?>
			
				
					
						labels->add_new_item );
						?>
					
				
				
					labels->add_new_item; ?>
					
					
						labels->parent_item_colon; ?>

The explanation

The first function — kc_unique_taxonomies — will find if you have set a taxonomy (or more) to be unique. You will have to add the taxonomy IDs using the available kc_unique_taxonomies filter hook (we’ll talk about it shortly). If there’s a unique taxonomy found, it will then remove the taxonomy’s default metabox in the post editing page, and replace it with the new one.

Note:
This function will only search for hierarchical taxonomies, because I strongly believe that a post should be allowed to have multiple non-hierachical taxonomy terms (ex: tags). Also, non-public and orphan taxonomies (taxonomies that are not attached to a post type) will be ignored.

The second function — kc_terms_radiolist — will display the replacement metaboxes for each unique taxonomies that use radio inputs for the taxonomy’s terms. I basically just took WordPress default category metabox and adjusted some parts of it.

Usage

The last step is to actually set some taxonomies to be unique which you can either do from your theme or plugin. Just add this snippet of code:

function my_unique_taxonomies( $arr ) {
	$unique_taxonomies = array( 'category' );
	return array_merge( $arr, $unique_taxonomies );
}
add_filter( 'kc_unique_taxonomies', 'my_unique_taxonomies' );

You can add more taxonomies to the $unique_taxonomies array if you want.

Bugs, question? feel free to leave a comment below :)

WordPress Attachment Category/Terms

Dzikri Aziz — Mon, 21 Feb 2011 18:25:26 +0000

I was working on a photography site project for a dear friend of mine, Virda, and it requires me to set categories/terms for the attachment images. By default, an attachment post will inherit its parent terms, but, what if we only need to pull attachments which have certain terms? Querying their parents and then filtering the result will surely need more time and resources don’t you think? Besides, we won’t have the freedom to set the attachments’ terms without modifying their parent posts.

Update:
I’ve updated the code (fixes/cleanups, enhancements) and create a complete WordPress plugin for it with i18n support. You can download it here. I’ll submit this plugin to the repository and will update this post when it’s live.

Update 2:
I’ve created a plugin for this so you won’t need to edit your theme/plugin files anymore :) Download it from WordPress plugins repo.

So I searched for a solution on the interweb and found the closest one to my liking at WP StackExchange which is now available as a plugin. Unfortunately, this solution needs javascript (jQuery) which in my opinion should be avoided for this kind of things. So I began learning the code and modify it to suit my needs.

As usual, you can add these codes to your theme’s function.php file, or you can create a new php file and place it inside the wp-content/mu-plugins directory (create it if it doesn’t exist yet). The second method is preferable so you’ll still have this functionality no matter what theme you’re using.

OK, let’s get started.

Register attachment taxonomies

function kc_attachment_taxonomies() {
	$taxonomies = array( 'category', 'post_tag' );
	foreach ( $taxonomies as $tax )
		register_taxonomy_for_object_type( $tax, 'attachment' );
}
add_action( 'init', 'kc_attachment_taxonomies' );

The code above will register category and post_tag taxonomies for the attachment. You can add more taxonomies to the array if you like, but you’ll have to register them beforehand.

Note:
You can also hook kc_attachment_taxonomies function into admin_init to reduce function calls when WordPress is loaded on the frontend, but you won’t be able to get any result when calling get_attachment_taxonomies() on the frontend.

Attachment fields

function kc_attachment_fields_to_edit( $fields, $post ) {
	$taxonomies = get_attachment_taxonomies( $post );
	if ( empty($taxonomies) )
		return $fields;

	foreach ( $taxonomies as $tax ) {
		$tax_object = (array) get_taxonomy( $tax );
		if ( !$tax_object['public'] )
			continue;
		if ( empty($tax_object['label']) )
			$tax_object['label'] = $tax;
		if ( empty($t['args']) )
			$tax_object['args'] = array();

		$att_terms = array();
		$post_terms = get_object_term_cache( $post->ID, $tax );
		if ( empty($post_terms) )
			$post_terms = wp_get_object_terms( $post->ID, $tax, $tax_object['args'] );
		if ( !empty($post_terms) )
			foreach ( $post_terms as $post_term )
				$att_terms[$post_term->term_id] = $post_term->name;

		$tax_terms = get_terms( $tax, array('hide_empty' => false) );

		$html = "\n";

		if ( !empty($tax_terms) )
			foreach ( $tax_terms as $term )
				$html .= "\tterm_id, $att_terms), true, false)." /> {$term->name}\n";

		$html .= "\t\n";
		$html .= "\n";


		$fields[$tax]['input'] = 'html';
		$fields[$tax]['html'] = $html;
		$fields[$tax]['helps'] = __( sprintf('Check/uncheck existing %s, or add new one(s), separated by commas.', $fields[$tax]['label']) );
	}

	return $fields;
}
add_filter( 'attachment_fields_to_edit', 'kc_attachment_fields_to_edit', 10, 2 );

By default, when we registered a taxonomy for the attachment post_type, WordPress will add an input field in the attachment form. We can then fill it with the term names (separated by commas) and WordPress will set them for the attachment. This is not cool, because we’ll have to remember exactly the term names we want to set for the attachment, otherwise, a new term will be created each time we made a typo :)

The function above will create a list of existing term names from each taxonomy and also an empty input field in case you need to add a new term.

Attachment form with term list

Attachment data

function kc_attachment_fields_data() {
	if ( empty($_POST['attachments']) )
		return;

	foreach ( $_POST['attachments'] as $id => $data ) {
		$taxonomies = get_attachment_taxonomies( $id );
		if ( empty($taxonomies) )
			continue;

		foreach ( $taxonomies as $tax )
			if ( isset($data[$tax]) )
				$_POST['attachments'][$id][$tax] = trim( join(',', $data[$tax]) );
	}
}
add_action( 'init', 'kc_attachment_fields_data' );

The last step is to intercept the posted data when we save the attachment. When saving the attachment data, WordPress expects the terms data as a string which will be converted to an array. But, because we’ve already modified the field, the terms data is sent as an array. I tried to find a filter hook to modify the data, but unfortunately it’s not available (yet), so we need to use the init hook to modify it. Don’t worry though, the function will exit as soon as it found out that the $_POST data doesn’t contain what it needs, so it won’t waste your server’s CPU cycle :)

kc_attachment_fields_data‘s job is pretty simple; take each attachment’s term data for each taxonomy and convert it to a string by separating each term with a comma, and then give it back to $_POST so WordPress can use it when updating the attachments.

Done!

Usage

To pull attachments from certain categories/terms, we can use what we usually use to pull ordinary posts/pages, either query_posts, get_posts, or even better, WP_Query class. To keep it simple, we’ll use get_posts, for the example:

$images = get_posts( array('post_type' => 'attachment', 'category__in' => array(1,5,6,7))  );
if ( !empty($images) ) {
	foreach ( $images as $image ) {
		echo wp_get_attachment_image($image->ID).'
';
		echo $image->post_title .'
';
	}
}

That should give you some attachment images that are member of categories 1, 5, 6 and 7 (if you have any, off course).

What’s next?

I’m not quite done with this. I think it’d be sweet if I could set which taxonomy should be registered for certain file types (which should be pretty simple to do I guess). I may also come up with other new ideas along the way, but for now I think it’s more than enough :)

Add Custom Class(es) to ANY Widget

Dzikri Aziz — Sat, 20 Nov 2010 20:37:48 +0000

WordPress has a powerful API for creating, configuring and displaying widgets, but one thing I really need is the ability to add custom class(es) to the widgets. Every widget should usually come with its own classname, which will be printed when the sidebar is being displayed. So, assuming you’ve used the correct method for registering sidebar, you can add these following functions to your theme/plugin to provide the user the ability to add custom class(es) to the widgets.

Update
I’ve created a plugin for this so you won’t need to edit your theme/plugin files anymore :) Download it from WordPress plugins repo.

There are three steps involved:

Adding an input field on the widget configuration form
Updating the widget options
Adding our custom class(es) to the widget markup

function kc_widget_form_extend( $instance, $widget ) {
	if ( !isset($instance['classes']) )
		$instance['classes'] = null;

	$row = "\n";
	$row .= "\tAdditional Classes (separate with spaces)\n";
	$row .= "\t\n";
	$row .= "\n";

	echo $row;
	return $instance;
}
add_filter('widget_form_callback', 'kc_widget_form_extend', 10, 2);

The kc_widget_form_extend() simply adds a new input field on the widget configuration form. You can add another field here if you’re feeling adventurous :)

function kc_widget_update( $instance, $new_instance ) {
	$instance['classes'] = $new_instance['classes'];
	return $instance;
}
add_filter( 'widget_update_callback', 'kc_widget_update', 10, 2 );

The kc_widget_update() functions added a new option to the widget which will be saved to the database when you hit the Save button.

function kc_dynamic_sidebar_params( $params ) {
	global $wp_registered_widgets;
	$widget_id	= $params[0]['widget_id'];
	$widget_obj	= $wp_registered_widgets[$widget_id];
	$widget_opt	= get_option($widget_obj['callback'][0]->option_name);
	$widget_num	= $widget_obj['params'][0]['number'];

	if ( isset($widget_opt[$widget_num]['classes']) && !empty($widget_opt[$widget_num]['classes']) )
		$params[0]['before_widget'] = preg_replace( '/class="/', "class=\"{$widget_opt[$widget_num]['classes']} ", $params[0]['before_widget'], 1 );

	return $params;
}
add_filter( 'dynamic_sidebar_params', 'kc_dynamic_sidebar_params' );

The last step is to modify the widget’s markup. When you call the dynamic_sidebar() function, WordPress prepares the markup for every widget, including its id and classes. It took me a while to figure out a way to modify the markup and I’m not really sure that it’s the best one, but it sure does the job :)

First, we pull all registered widgets from the global $wp_registered_widgets variable. Since we don’t want to modify all widgets, we need to filter the one we want using the $params variable that WordPress passed to our function. When we found the widget, we’ll check if it has custom class(es) added, and then add them to its markup.

Now you can use those custom classes in your stylesheet to give your widgets some unique look n’ feel :)

Temporary Fix for Regenerate Thumbnails 2.0.3

Dzikri Aziz — Thu, 04 Nov 2010 12:21:42 +0000

I was building a WordPress a theme, and I needed to rebuild the post attachment thumbnails. As usual, I used Alex’ amazing Regenerate Thumbnails plugin. Upon clicking the button, I got nothing. No progressbar, nothing. I checked the attachment directory and found that the thumbnails weren’t rebuilt.

So I looked at Firebug console and found an error thrown, $.widget is not a function and I realized that I was using the trunk version of WordPress. It throws an error because WordPress just got its jQuery and jQuery UI scripts updated to the latest versions. Also, the ‘widget’ part of jQuery UI is now has its own handler, ‘jquery-ui-widget‘ while previously it was part of ‘jquery-ui-core‘ (I believe).

The fix is easy, you can follow these steps:

Download the newest jQuery UI bundle and unpack it.
Copy the new jquery.ui.progressbar.js (located in the development-bundle/ui/ directory) into the Regenerate Thumbnails plugin directory (wp-content/plugins/regenerate-thumbnails/jquery-ui/).

Open the plugin script (regenerate-thumbnails.php) with your favorite editor and edit line 59 with this:

wp_enqueue_script( 'jquery-ui-progressbar', plugins_url( 'jquery-ui/jquery.ui.progressbar.js', __FILE__ ), array('jquery-ui-core', 'jquery-ui-widget'), '1.8.5' );

Now you can rebuild your thumbnails.

Because this problem only occur when running the trunk version of WordPress, I don’t think the plugin needs to be updated (yet). I’m sure Alex will update it when WordPress 3.1 come out and I’ll be sure to remind him. He usually responds quickly, so no need to worry :)

KC Settings

Dzikri Aziz — Mon, 25 Oct 2010 12:20:17 +0000

I’ve been writing WordPress themes for these past two years. Some of them are very simple and some others are quite complex. These themes need a settings panel so the user (or the site admin) can configure their site comfortably. There are many methods around the interwebs on how you can create such a settings panel for your theme/plugin. I tried to adapt some of them into my themes, but there was always something wishpering in my ear telling me to write my own settings panel with my own way :) .

The closest thing I found was the method used by Hybrid, Justin Tadlock‘s very powerful theme framework. However, it lacks some features I need, and it’s not too comfortable to work with. I like the way it uses the metaboxes to present the options though, it’s very WordPress :)

So I began playing with Hybrid’s code and altered the way it handles the options, but keep the presentation intact. I got it working the way I wanted it to, until I need to add another feature (other option type and validation). I came across Otto’s article about WordPress’ Setting API and it inspired to rewrite the code.

After a few fun days, I finally got it right and made it as a plugin so everyone can use it in their project. It still lacks some features (like file upload), but (I think) the base code is easy enough to modify so it won’t take long before I add them :)

For you WordPress lovers out there, here I present my very first public plugin, KC Settings.

Update:
This plugin is now hosted at WordPress plugins directory.

I’ve included a readme.html file so you should read it before using the plugin. The documentation is not complete yet, but should be enough to get you started. Any questions, bug reports, please feel free to contact me.

Add Custom Attributes to WordPress’ Posts Navigation

Dzikri Aziz — Fri, 27 Aug 2010 17:47:48 +0000

The Problem

We need to add our custom class(es) to the posts navigation links to be able to add some styles.

The Solution

Use the available next_posts_link_attributes and previous_posts_link_attributes hooks.

How?

Open your theme’s function.php file and add these lines (must be inside the tag):

add_filter( 'next_posts_link_attributes', 'kc_next_post_link_attr' );
add_filter( 'previous_posts_link_attributes', 'kc_prev_post_link_attr' );

function kc_next_post_link_attr() {
	return 'class="next-page"';
}

function kc_prev_post_link_attr() {
	return 'class="prev-page"';
}

Tempelan

Dzikri Aziz — Thu, 26 Aug 2010 21:55:22 +0000

This is a simple CV site template for you who need a quick site to show your work/portfolio. It uses valid XHTML 1.1 Strict and easily modifiable. jScrollPane is used for the scrolling, but should degrade nicely when JavaScript is turned off. For the image popups, Fancybox did a nice job.

This template has a contact page, but currently doesn’t have the ability to send emails yet. I’ll try to integrate a simple PHP script when I have some free time, but in the meantime, you can of course integrate a script of your choice :)

Preview

Credits:

License: GPL v2
Links: Demo, Download

Hello!

Dzikri Aziz — Sat, 21 Aug 2010 21:56:20 +0000

Setelah sekian lama…. kucrut kembali lagi mencoba untuk mengisi blog ini.

Masih banyak bagian yang belum selesai dengan theme blog ini. Untuk itu jangan kaget bila penampilannya terus-menerus berubah dari waktu ke waktu :)

kucrut

Minimize KDE IM Contacts to System Tray

KC Settings Data

Add HTML Tags in Post and Widget Titles

3 Jagoan Internet

wp_list_pages() for Custom Post Types

Override max-width

KC DropBox

PulseAudio Equalizer

KDE 4.8 Taskbar

Using Built-in Post Finder in Plugins

Move Cursor to the Next/Previous Paragraph in Kate

jQuery in Widgets Admin Page

Hacking Term List Table

Setting Default File Permission in Linux™

Midori

Add Panel to Debug Bar

Customize post type archive order

Register Post Type

Customize archive order

RMS

Reminder: Laptop Mode Tools for 3.1.x kernels

Smart Firefox

WordPress Theme: Polos

Separate Comments and Pings (Trackbacks/Pingbacks)

Comments template

Get comments count

List Comments

List pings

List all responses (comments and pings)

KC Settings 2.0

KC Media Enhancements

KC Widget Enhancements

Remove Protected Post Title Prefix

Reminder: add_action

Insert Image with Custom Size into Post

Unique post category/term

The result

The code

labels->add_new_item ); ?>

The explanation

Usage

WordPress Attachment Category/Terms

Register attachment taxonomies

Attachment fields

Attachment data

Usage

What’s next?

Add Custom Class(es) to ANY Widget

Adding an input field on the widget configuration form

Updating the widget options

Adding our custom class(es) to the widget markup

Temporary Fix for Regenerate Thumbnails 2.0.3

KC Settings

Add Custom Attributes to WordPress’ Posts Navigation

The Problem

The Solution

How?

Tempelan

Preview

Credits:

Hello!