Lately I’ve been working on my 2nd plugin–commentmailer (currently in ver 0.1)–and found that it needs special i18n treatment. Unlike most plugins that need gettext to localize their appearance on the web page, commentmailer prints the localized strings into an e-mail.

Even as a non-English blog author, sometimes you do need to answer your visitor’s comment in English. More than that, if you are a true polyglot and writes your blog in several languages, you will also have to answer the comment in as many languages as you use. If you use commentmailer plugin to email those answers, you probably want to localize the email depending on the content language.

I’ve provided the localization schema to commentmailer since the first time I released it. But switching which language to use is as painful as changing your WordPress locale environment, unless you are using some multilingual plugin.

So I put some function that makes commentmailer prompt the user (blog author) with an option of which language he/she want to use to answer the visitor’s comment. It searches for commentmailer localization files inside your plugin dir and print a locale selection menu to your comment form.

Here’s what you need to do to take some advantage of this new feature:

1. Update your commentmailer plugin to the latest version
2. Use the localization template (commentmailer.pot) included in the distribution file to localize the plugin. Name your localization file (the machine object) commentmailer-[locale].mo and put it directly inside the plugin directory–next to commentmailer.php
3. Using the corresponding WordPress localization is recommended since it will localize the date format printed in you e-mail
4. When you are writing a reply in the comment form, select the language in which you are writing
5. Of course you have to write the comment content in your language to match your preferred locale

Salah satu contoh sederhana penerapan penggunaan WordPress yang ingin saya bahas di sini ialah sebagai engine sebuah situs surat kabar harian. Ini bukan artikel tutorial lengkap, sekedar sebuah wacana, dilengkapi dengan sedikit scripting kasar yang membantu Anda melangkah ke sana.

Fitur-fitur yang menjadi persyaratan untuk sebuah situs surat kabar antara lain:

1. Halaman utama dapat berupa halaman selamat datang ataupun langsung cuplikan berita-berita hari ini. Namun bentuk yang pertama saya sebutkan agaknya sedikit merepotkan bagi pengunjung.
2. Halaman yang menampilkan suatu berita secara utuh
3. Halaman yang menampilkan cuplikan seluruh berita pada tanggal tertentu.
4. Menu yang disajikan sedemikian rupa sehingga memudahkan pengunjung untuk memilih hari/tanggal/edisi tertentu dari surat kabar yang bersangkutan. Biasanya disajikan dalam bentuk kalender bertaut.

Untuk mewujudkan fitur-fitur yang ada di atas, kita dapat membuat templat suai (custom template) yang agak berbeda dengan templat blog biasa.

Halaman Utama

Sebagai contoh, sebuah koran bernama “example” menggunakan situs yang beralamat di http://example.com. Dengan mengklik URL tersebut, pengunjung akan melihat cuplikan berita-berita untuk hari ini.

Untuk menciptakan halaman utama yang demikian, yang perlu kita lakukan ialah membuat struktur loop berikut dalam berkas index.php tema Anda.

<?php get_header(); ?>

[struktur halaman sebelum loop]

<?php
$query = 'year=' . date('Y') . '&monthnum='
. date('m') . '&day=' . date('d');
query_posts($query);
if (have_posts()) :
	while (have_posts()) :
		the_post(); ?>

		[struktur halaman dalam loop]

	<?php endwhile; ?>
<?php endif; ?>

[struktur halaman setelah loop]

<?php get_footer(); ?>

Yang membedakan loop di atas dari loop standar WordPress ialah dipanggilnya fungsi query_posts() dengan parameternya yang berisi tahun, bulan dan tanggal tulisan yang ingin diambil (tahun, bulan dan tanggal saat ini). Data tersebut diambil dari server menggunakan fungsi date(). Oleh karena itu, halaman utama ini selalu menampilkan artikel hari ini, bukan sejumlah artikel terakhir berdasarkan kronologis waktu seperti blog pada umumnya.

Jika artikel untuk koran terbitan esok sudah siap, sang editor bisa saja langsung menerbitkannya ke web menggunakan tanggal besok sebagai tanda waktunya, tanpa khawatir tulisan tersebut akan muncul di halaman muka (edisi hari ini). Setelah hari berganti, begitu juga dengan tanggal dalam server maka tinggal ucapkan manteranya, “paginagenerosa..!!“. Dan halaman muka secara otomatis berganti menjadi berita-berita di hari berikutnya.

Struktur halaman dan berita dapat Anda kreasikan sendiri sesuka Anda. Silakan membuat tampilan halaman seprofesional mungkin. Paduan antara ringkasan berita dan miniatur (thumbnail) akan tampak manis, dengan masing-masing dilengkapi taut ke permalink berita tersebut.

Halaman Artikel Tunggal

Halaman ini yang akan dimunculkan setelah pengunjung mengklik salah satu (permalink) cuplikan berita. Halaman ini seperti laiknya sebuah halaman single post dalam blog. Sesuaikan berkas single.php tema Anda untuk menentukan struktur halaman ini.

Ide yang bagus untuk tetap mencantumkan taut ke artikel lainnya pada edisi yang sama. mungkin di kolom sisi (sidebar).

Halaman Edisi Tanggal XX/XX/XXXX

Anda yang biasa menggunakan WordPress mungkin sudah mengenal halaman arsip serta berkas archive.php dalam tema (theme). Berkas ini akan digunakan ketika WordPress menerima kueri publik tertentu. Dalam versi 2.3, ada tiga belas variabel kueri publik yang akan memicu pemanggilan berkas archive.php. Empat diantaranya yang dapat kita gunakan dalam bagian ini ialah variabel tahun (year), angka bulan (monthnum) dan tanggal (day). Sebagai alternatif dari year, monthnum dan day, Anda juga bisa menggunakan variabel m, yaitu penggabungan string tahun, bulan dan tanggal.

Cara menerima kueri publik dari pengunjung ialah dengan memasukkannya pada URL. Sebagai contoh, jika Anda ingin menyediakan halaman arsip berita untuk edisi terbitan 12 Juni 1985, maka gunakan URL berikut:

http://example.com/?year=1985&monthnum=06&day=12

Atau alternatif lainnya:

http://example.com/?m=19850612

Sedangkan untuk menanggapi kueri publik tersebut, kita akan bermain-main dengan loop di berkas archive.php. Kira-kira berikut struktur berkas archive.php yang perlu Anda buat.

<?php get_header(); ?>
<?php if (have_posts()) : ?>
<?php $post = $posts[0]; ?>
<?php } if (is_day()) { ?>

[struktur pembuka hal. edisi tgl xx/xx/xxxx]

<?php while (have_posts()) : the_post(); ?>

[struktur hal. edisi tgl xx/xx/xxxx dalam loop]

<?php endwhile; ?>

[struktur penutup hal. edisi tgl xx/xx/xxxx]

<?php } elseif (is_month()) { ?>

	[struktur halaman edisi bulan xx/xxxx]

<?php } elseif (is_year()) { ?>

	[struktur halaman tahun xxxx]

<?php else : ?>

	[struktur halaman "tidak ditemukan"]

<?php endif; ?>
<?php get_footer(); ?>

Pada struktur di atas, bila kueri publik “day” atau “m” (asalkan mencakup tanggal) diterima, maka akan dilakukan loop yang mengambil berita-berita pada tanggal tersebut. Dengan loop ini, kita bisa menyusun tampilan halaman yang mirip seperti halaman utama, namun dengan konten berita di edisi terdahulu. Anda juga bisa membuatnya lebih sederhana daripada halaman utama, terserah Anda yang mendesainnya.

Placeholder [struktur halaman edisi bulan xx/xxxx] di atas merupakan tempat di mana Anda membuat struktur halaman yang tampil jika pengunjung mengirim kueri bulan dan tahun. Sebagai contoh, jika pengunjung mengklik URL:

http://example.com/?m=200706

Strukturnya tergantung apa yang ingin Anda sajikan di sini. Dalam contoh di atas saya tidak memasukkan loop di dalam sini dengan asumsi bahwa untuk sebuah situs surat kabar harian, akan banyak sekali tulisan yang memenuhi faktor inklusi bulan dan tahun tertentu. Sebagai alternatifnya, Anda bisa menampilkan taut-taut ke masing-masing edisi di bulan tersebut. Atau, dengan sedikit penyesuaian (customization) loop, Anda dapat mempersempit kueri dengan hanya menampilkan kategori tertentu, misalnya: berita utama hari itu.

Untuk placeholder [struktur halaman tahun xxxx], saya rasa perlakuannya hampir sama.

Rubrik

Pengelompokan artikel-artikel dalam surat kabar ke dalam rubrik-rubrik tertentu dapat dilakukan dengan menggunakan fitur “Kategori” dalam WordPress. Menilik struktur perubrikan dalam media cetak, rasanya tidak mungkin sebuah artikel memiliki lebih dari satu kategori. Hal ini nantinya akan mempermudah klasifikasi tulisan. Jika ingin membuat pengelompokan artikel yang mengenal irisan (intersection), gunakan sistem tag natif WordPress.

Pretty Permalink & URL

Salah satu kelebihan WordPress ialah sistem pretty permalinknya yang solid. Bahkan, format yang disarankan (recommended) WordPress, yaitu berdasarkan penanggalan–/%year%/%monthnum%/%day%/%postname%/, amat cocok diterapkan pada sebuah situs surat kabar harian.

Dengan format ini, jika pengunjung ingin melihat edisi cetak tanggal 28 Oktober 2007, maka ia cukup mengunjungi alamat ini:

http://example.com/2007/10/28

Pengunjung yang cerdas tidak akan kesulitan melakukan navigasi untuk mencari edisi yang dicari. Juga tidak perlu menghapal format URL kompleks yang penuh dengan tanda “?“, “&” dan “=“.

Kalender

Ini merupakan salah satu alat navigasi yang amat membantu sebuah situs dengan arsip artikel yang sangat banyak seperti situs surat kabar. WordPress telah dilengkapi dengan widget yang salah satu di antaranya ialah kalender. Kalau Anda tidak menginginkan kalender di kolom sisi, Anda pun dapat membuat kalender sendiri di manapun. Berbagai macam fungsi bawaan WordPress sangat membantu. Fitur pretty URL WordPress pun akan mempermudah menentukan tujuan taut kalender tersebut.

Input Berita

Dengan menggunakan engine WordPress, proses input berita menjadi sangat sederhana. Dengan sedikit pelatihan wartawan dapat langsung melakukan entri konten. Sistem pengelompokan pengguna berdasarkan “peran” dapat kita manfaatkan. Misalnya, seorang wartawan diberi “peran” sebagai “kontributor”. Ia dapat memasukkan naskah dan menyimpannya. Kemudian seorang editor yang akan mengevaluasinya dan menerbitkannya, dengan terlebih dahulu mengatur tanggal berita tersebut.

Tambahan

Uraian di atas menunjukkan bahwa WordPress amat sesuai untuk dijadikan sebuah engine situs web surat kabar. Yang saya sampaikan masih berupa gambaran kasar. Silakan Anda mengembangkannya.

Berikut beberapa hal tambahan yang harus dipikirkan dalam membuat templat WordPress untuk sebuah situs surat kabar:

1. Antisipasi pengunjung yang mengunjungi halaman berita untuk besok menggunakan kueri “m”. Jangan sampai ia melihat berita sebelum waktunya tiba (pergantian tanggal). Hal ini bisa dilakukan dengan membuat kondisi di berkas archive.php
2. Jika suatu hari tidak ada berita sama sekali (misal: harian itu tidak terbit dikarenakan hari libur nasional), maka jangan sampai pengunjung melihat halaman kosong. Sesuaikan berkas index.php Anda. Misal: alihkan ke hari terakhir di mana masih ada berita.
3. Sesuaikan pula umpan RSS dan atom situs Anda
4. Hmm.. apa lagi ya? Kalau Anda punya pendapat, silakan tambahkan dan kita diskusikan di bagian komentar

Yang ingin saya sampaikan di sini ialah bahwa menggunakan sebuah aplikasi blog seperti WordPress dalam sebuah situs surat kabar bukanlah berarti kompromi. Aplikasi blog yang nampaknya sederhana ini justru dapat meningkatkan efisiensi pengelolaan konten situs Anda.

Kompleksitas situs yang Anda harapkan dapat dicapai dengan membuatkan aplikasi lagi di atasnya, baik dalam templat (theme) atau plugin. Sebisa mungkin hindari penyuntingan skrip inti WordPress (berkas-berkas di direktori akar dan dalam direktori wp-includes dan wp-admin). Ini memudahkan Anda untuk terus mengikuti pengembangan WordPress dan memutakhirkan instalasi WordPress Anda ke versi yang terbaru).

Why You Should Use This Plugin

• You’ll never know whether your blog commenters is going to visit back to look for your reply for his/her comment, subscribe a comment feed for a specific post, or choose to receive notification e-mail (if you provide one). By using this plugin, you’ll have a full control to decide whether it is necessary to notify a commenter for a new reply.
• It keeps the discussion rolling on your blog comment system.

Grab it

Currently there is only unstable version of this plugin. But yet, you can still take the advantage by installing it. Use the following link to download the plugin.

commentmailer-0.1-beta

Installation

1. Download the package and decompress it
2. Upload the file named commentmailer.php to your /wp-content/plugins/ directory
3. Go to your Plugin activation section and activate the plugin
4. Well done!
5. If necessary, you can configure anything on the admin panel. Login into your wp-admin and select Options -> CommentMailer

Usage

If you are logged in as an administrator on your blog, you’ll see an additional list menu on the comment submission form. Select the commenters to whom you are going to send a notification e-mail. Then click the submit button as usual. Leave the rest to the plugin to work

Localization

There is still only one localization available for this plugin: Bahasa Indonesia. If you are interested in translating it into your language, you can use the template (commentmailer.pot) file included in the plugin package archive. You can send the translation result back to me so I could include the translation in the next release.

Localization plays an important role in this plugin since it determines the content of your notification e-mail.

To use the localization, simply upload the desired .mo to your plugin directory (/wp-content/plugins/). Your WPLANG value in your wp-config.php should match the .mo file. e.g. you should use the id_ID.mo if your WPLANG is set to id_ID.

Frequently Asked Questions

Can my blog visitors use same list menu to send comment notification to the other commenters?

No unless they are registered as your blog user and are logged in when they are submitting a comment. Otherwise they would see the regular comment form, without the additional list menu.

The e-mail header configuration can only be filled with a single setting (single sender name, single e-mail address). How could a multi user blog specify multiple settings for the plugin?

You couldn’t. But you can leave it blank so that the display name and email address from the user profile will be used instead of the commentmailer option

Why I don’t see any extra options on the comment submission form?

It’s probably because your theme doesn’t have a hook called comment_form. I use this hook to automatically insert the multiple list menu containing the names of the commenters. Check your theme file for a code that look like this: <&php do_action('comment_form', $post->ID); &> Usually it’s located inside ‘comments.php’. If you don’t have one, try adding it manually.

Version History

• September 2 2007 – Version 0.1-beta
  Major fixes for previously broken functions. The multiple list is now working.
• August 20 2007 – Version 0.1-alpha
  Initial release. The multiple list is not 100% working actually. You could only send notification to 1 visitor. I have recoded the list and will surely provide the real multiple list function in the next release. (soon ).

Do you love telling everybody whether you are online or not by adding your Yahoo Messenger online status to your blog? If you do, you might have been familiar to these standard YM online status button:

Bored with these button?

For you, WordPress users, I’ve written a simple plugin which allows you to show your YM online status using your custom images, so you can make sure that your online status button looks good on your blog’s theme and layout. My Yahoo Messenger online status button on the sidebar of this blog is a simple example for this plugin. Of course, this is only an example. You can create better buttons on your own.

Interested? Just download the latest version of this plugin and put it on your blog

Latest stable version:
ym-online-status-0.3

Installation and Usage:

1. Decompress this plugin’s archive file. It contains a folder named ‘ym-online-status’
2. Upload the folder into your plugins directory which is located by default in /wp-content/plugins/ After uploading this folder, you should have a structure like this: /wp-content/plugins/ym-online-status/[some files + folder]
3. Go to your admin section and select Plugins menu. Activate this plugin from the panel.
4. Now go to Options, select the YM Status submenu (you’ll find this new submenu after activating this plugin). Fill in the ‘Yahoo Messenger ID’ field with your yahoo id. If you’d like to enter some different ids, separate each id with a space (see further notes about using multiple yahoo ids). The ‘Text’ field on the options represents the value of ‘alt’ and ‘title’ attributes of your button. It will show up as a tooltip when you hover your mouse pointer on your button and where browsers doesn’t load your button image.
5. Select your preferred YM status button to display.
6. Click the ‘Update Options’ button.
7. Enter this code into your theme file, in which your online status button will be displayed:<?php get_ym_status() ?>It’ll be nice to put it in your sidebar.php, but it is up to you where you would like it to be displayed.
8. Congratulations! Now you have a unique YM online status button.

Using your own image

I have included some sample online status buttons which you could use on your blog. But if you’d like to use your own creation, please follow these steps:

1. Prepare a pair of images. One is for showing the visitors that you are online, and the other one is for showing that you are offline. These paired image’s format and extension have to be identical. You can’t pair an online .jpg image with an offline .gif image. I also suggest that you use a pair of image with the same pixel dimension, although this isn’t a must.
2. Name each of the images as online-[image_name].[extension] and offline-[image_name].[extension] As an example, you might want to name them as online-myimage.gif and offline-myimage.gif.
3. Upload these images into this directory: /wp-content/plugins/ym-online-status/images/
4. Get into the admin panel, select the Options menu and then the YM Status submenu. Select your custom images as your online status button just like you did before, and then click the Update Options button.

If you would like to share your custom images to WordPress communities, I would be glad to include them in this plugin, accompanied with the author’s credits and blog urls of course. Please send me your custom images via email: hudatoriq [at] gmail [dot] com. The images must be in PNG format, with 32 bits per pixel color depth (with 8 bit per pixel transparency).

Using multiple yahoo ids

If you want to display the online statuses of several yahoo ids, please follow these steps:

• In the YM Status Option page, specify multiple yahoo ids in the field labeled ‘Yahoo Messenger ID’. Separate each ids with a space.
• To display all these ids at once, simply use this function on your theme file: <?php get_ym_status('list') ?> This will display the YM status of the given ids in an unordered list format.

If it doesn’t fit your theme/layout, you can create your own HTML tags structure. Use this tags to show your custom image with link that executes Yahoo Messenger program when clicked:<a href='ymsgr:sendim?[yahoo_id]' title='[title text]'>
<img src='[weblog root]/wp-content/plugins/ym-online-status/image.php?id=[id number]' alt='[title text]' />
</a>


You should replace the value inside [ and ] as noted below:

• [yahoo id] with your yahoo id/username
• [title text] with your custom text that you will use as a tooltip
• [weblog root] with your web log root url
• [id number] with the number dengan urutan keberapa id tersebut ditulis dalam field ‘Yahoo Messenger ID’. Misalkan Anda mengisi id-id berikut: tono tini tina. Jika ingin menampilkan status online tina, ganti nilai ini dengan nomor 3. Jika ingin menampilkan status online tono, ganti dengan nomor 1.

Localization

Available translation file:

• Bahasa Indonesia

Frequently Asked Questions

Can somebody else use my image URL to show their YM online status on other site/weblog?

Yes, they can, provided that you allow them by specifying their yahoo username in the Options panel. Otherwise, they won’t be able to do this. You actually are able to lend your friends some help by hosting their custom image status while they don’t have the ability to use it due to their bloghost service limitation. Just tell them to use this url as their image source: [your weblog url]/wp-content/plugins/ym-online-status/image.php?id=[id number]

Why does the button look bad on my blog? There is a rectangular gray background surrounding the button.

That’s probably due to incompatibility with your browser. The images included in this plugin is in PNG format. Besides storing color information, it also stores 256 level of transparency information for each pixel. It makes PNG image’s transparency look perfect on any background color. But unfortunately not all browser support this. If you use Internet Explorer prior to version 7.0, then you’ll have a good chance to face this problem. If you want your button to look fine in browsers that doesn’t support PNG’s transparency, try editing the image with some graphic editor. Remove the image transparency. Use your blog’s background color as your image’s background, then upload it back to your server.

How do I upload my custom images into the designated directory? I can’t find any upload panel to do this from the YM Status Options Menu

Unfortunately I haven’t provided a form to upload images from the Admin panel yet. You have to upload it via FTP or your web host file manager.

Copyright Notices

This YM Online Status plugin for WordPress is released under GPL (General Public License).

Yahoo!, Yahoo! Messenger, Yahoo! logo, and some smiley image taken from Yahoo! website or Yahoo Messenger software are registered trademark and properties of Yahoo! Inc. This plugin is not officially released nor supported by Yahoo! Inc. Yahoo! is not responsible for the usage of this plugin on your blog.

Version History

• Jul 14 2007 – Version 0.2
  Bug repair – collision with other admin buttons named ‘submit’ that creates undesired update triggers
  Compatibility fixes with WordPress 2.0 regarding array serialization
  Auto redirection to configuration page after activation
  Automatically assign smile.png as the default status button after plugin activation
  Notification messages in configuration page
  Using WP’s built in ‘init’ hook to intercept user (admin) input (I should’ve done it earlier )
  Other minor changes (localizations, code cleaning, etc)
• May 3 2007 – Version 0.1
  Now PHP 4 compatible (tested with PHP 4.3.11)
• May 2 2007 – Version 0.1 Beta
  Initial release, still having problems with PHP 4.x.x