Membuat Custom Extension Anda Sendiri untuk PopClip

() translation by (you can also view the original English article)

PopClip adalah salah satu aplikasi favorit kami di Mactuts+ dan salah satu alasan mengapa ini mendukung extensions. Anda dapat melakukan tindakan pada teks yang dipilih menggunakan PopClip yang membuatnya sangat fleksibel, apakah Anda ingin membuka tautan di browser lain, mencari teks yang dipilih di Google atau menambahkannya sebagai hal yang harus dilakukan pada Things, PopClip menyediakan gaya iOS menu pop-up yang membuat melakukan tugas-tugas ini mudah.

Dalam tutorial ini, saya akan menunjukkan betapa mudahnya membuat extension Anda sendiri untuk PopClip untuk melakukan custom action.

Apa Itu PopClip?

PopClip provides an iOS-style menu that can be further customised with extensions — PopClip menyediakan menu bergaya iOS yang dapat disesuaikan lebih lanjut dengan extensions

PopClip ($4.99) adalah aplikasi untuk OS X yang menyediakan menu pop-up seperti iOS saat memilih teks. Penggunaan utamanya adalah untuk cut, copy dan paste - sekali lagi, sangat mirip dengan iOS. Yang benar-benar menarik adalah kemampuan untuk menginstal extensions agar melakukan lebih dari sekadar menambah clipboard.

Pada saat penulisan, ada lebih dari 92 extensions tersedia untuk didownload secara gratis. Extensions ini berkisar dari membuka tautan di Google Chrome, memposting teks yang dipilih ke Facebook, menambahkan tanda kutip di sekitar teks yang dipilih dan banyak lagi.

Tips: Ada banyak extensions dan saya menganjurkan Anda untuk melihatnya, yang semuanya dapat ditemukan di halaman extension PopClip.

Saya menggunakan PopClip secara teratur dan menggunakan extensions untuk menambahkan teks yang dipilih ke Things, to-do app pilihan saya.

Bagaimana Mereka Dibangun

PopClip mendukung extensions yang ditulis dalam beberapa cara berbeda:

Layanan Mac OS X
AppleScript
Shell Script
URL
Keypress

Baik URL dan Keypress tidak memerlukan pengetahuan pemrograman untuk membuatnya. Selama Anda tahu URL situs yang dapat menyertakan beberapa teks atau untuk menekan kombinasi tombol tertentu, maka Anda dapat membuat extension Anda sendiri.

Tiga sisanya dibuat menggunakan bahasa scripting. Mereka dapat memanipulasi teks dengan cara yang lebih maju. Untuk keperluan tutorial ini, saya akan membuat extension menggunakan metode URL.

Ekstensi URL hanya membutuhkan dua file, file konfigurasi ekstensi kita dan ikon untuk ditampilkan dalam menu pop-up ketika memilih beberapa teks.

Membangun Sendiri

Ada banyak pilihan ekstensi yang dapat digunakan tetapi mungkin tidak ada ekstensi yang sesuai dengan kebutuhan kita. Sebagai contoh, saya akan menunjukkan kepada Anda bagaimana membangun ekstensi PopClip yang dapat mencari Mactuts+ untuk teks yang dipilih.

Untuk melakukan ini, saya tidak akan menunjukkan kepada Anda bagaimana membangunnya dari awal tetapi, sebagai gantinya, kita akan menggunakan beberapa kode sampel yang disediakan oleh developer dan melakukan perubahan sesuai kebutuhan kita. Ini akan memberi Anda ide bagus tentang cara kerja extension dan perubahan apa yang perlu dibuat untuk mulai membuat extension kita sendiri.

Tips Kita hanya akan memerlukan editor teks untuk melakukan perubahan. TextEdit tidak ideal untuk mengedit kode, jadi saya akan merekomendasikan sesuatu seperti TextWrangler yang bukan hanya aplikasi hebat tetapi juga gratis!

1. Buat Folder

You can create this folder anywhere as it will just be somewhere to work from for now — Anda dapat membuat folder ini di mana saja karena hanya akan menjadi tempat bekerja untuk saat ini

Di desktop Anda (atau di mana pun Anda suka), buat folder bernama mactuts. Di sinilah kita akan menyimpan file extension kita sebelum mengubahnya menjadi extension PopClip yang tepat.

2. Download Kode Sumber

Di situs developer Ekstensi PopClip, kita dapat download beberapa kode sumber contoh. Di bawah tajuk General Overview, Anda akan melihat jenis tindakan yang didukung PopClip. Kita ingin mengunduh kode contoh untuk tindakan URL, yang merupakan kode sumber untuk extension Google Translate.

Anda akan melihat dua file dalam tampilan, Config.plist dan TranslationIcon.png. Kita hanya tertarik pada file Config.

Here is what the code looks like when it's opened/pasted into a text editor (in this case, TextMate) — Ini adalah kode yang terlihat ketika dibuka/disisipkan ke dalam editor teks (dalam hal ini, TextMate)

File konfigurasi utama extension adalah apa yang dikenal sebagai file Property List, atau dikenal sebagai Plist. Anda mungkin pernah mendengar tentang mereka sebelumnya karena jenis file sama yang digunakan OS X untuk menyimpan preferensi untuk aplikasi. Ini didasarkan pada format yang dikenal sebagai XML. Luangkan waktu beberapa menit untuk membiasakan diri dengan format ini.

Terlihat familier? XML dirancang untuk bekerja dengan cara yang mirip dengan HTML, bahasa markup yang digunakan untuk membangun halaman web.

Tips: Jika Anda ingin tahu lebih banyak tentang Property Lists, Developer Library Apple memiliki artikel pengantar luar biasa yang dapat Anda baca

Jika Anda tidak terbiasa dengan GitHub, Anda dapat download extension secara langsung. (Klik kanan tautan dan pilih Download File As..., simpan di folder mactuts yang dibuat sebelumnya).

3. Mari Edit!

Sekarang Anda seharusnya sudah menyimpan file Config.plist ke folder mactuts Anda. Mari kita edit file itu dalam editor teks.

Seperti yang Anda lihat, file ini memiliki sejumlah opsi yang dapat dikonfigurasi. Anda akan melihat bahwa suatu opsi disebut Key. Ini memberi tahu PopClip bahwa extension dapat memberikan informasi tertentu. Kita tidak akan mengubah key apa pun, tetapi sebaliknya kita akan mengubah informasi di dalamnya.

Langkah 1

The first thing we'll change is the name of the extension — Hal pertama yang akan diubah adalah nama dan deskripsi extension

Pertama-tama, kita perlu mengubah Extension Name dan Extension Description. Temukan baris yang memiliki key untuk ini dan ubah nama yang ada di string di bawah, yang saat ini ditulis sebagai "Google Translate". Ingat, jangan ubah key.

Sekarang setelah Anda mengubah nama extension, mari kita ubah deskripsi untuk mencerminkan fungsinya dengan lebih baik. Dengan menggunakan langkah-langkah yang sama seperti di atas, ubah deskripsi untuk lebih menggambarkan apa yang akan dilakukan ekstensi pencarian Mactuts+ kita. Saya akan menyerahkan kepada Anda untuk memutuskan apa yang harus ditulis.

Langkah 2

We'll also need to update the version as this is the first Mactuts extension ever! — Kita juga harus memperbarui versi karena ini adalah extension Mactuts pertama yang pernah ada!

Sekarang, karena ini adalah pertama kalinya kita membuat extension ini, mari kita buat versi 1. Lokasi nomor versi di dekat bagian atas file dan ubah dari 2 menjadi 1.

Anda mungkin telah memperhatikan bahwa, tidak seperti nama extension, ini adalah sesuatu yang disebut Integer dan bukan String. Integer berarti Anda hanya menentukan angka, jadi tidak ada huruf atau karakter khusus.

Langkah 3

The identifier needs to be changed as it is unique to each extension and developer — Pengidentifikasi perlu diubah karena unik untuk setiap extension dan developer

Setiap extension membutuhkan cara unik untuk diidentifikasi. Alih-alih menggunakan nama itu, ia menggunakan pengidentifikasi khusus yang terlihat seperti nama domain yang ditulis terbalik. Dalam kode sumber ini, Anda akan melihatnya ditulis sebagai berikut:

com.pilotmoon.popclip.extension.google-translate

Ubah ini sebagai berikut:

com.mactuts.extension.mactuts-search

Bahkan jika kita mengubah nama extension, PopClip masih akan bingung jika memiliki extension kita dan extension Google Translate diinstal pada saat yang sama.

Langkah 4

Sekarang saatnya mengontrol bagaimana extension bekerja. Extension kita akan mencari Mactuts+ untuk teks yang telah Anda pilih. Untuk melakukan ini, kita perlu tahu apa alamat pencarian kita.

Buka tab atau jendela baru dengan Mactuts+ dimuat dan cari kata kunci "TEST". Setelah pencarian selesai, lihat address bar. Anda harus melihat alamat berikut:

http://mac.tutsplus.com/?s=TEST

Dari ini, kita dapat melihat bahwa alamat pencarian kita adalah:

http://mac.tutsplus.com/?s=

Anda dapat menguji ini dengan memasukkan alamat di atas dan kemudian setiap kata kunci yang Anda inginkan ke address bar browser Anda. Setelah halaman dimuat, Anda akan melihat pencarian yang Anda inginkan.

PopClip menggunakan teks {popclip text} sebagai pengganti untuk teks yang Anda pilih. Artinya, alamat pencarian untuk extension kita adalah:

http://mac.tutsplus.com/?s={popclip text}

We'll now change the URL that PopClip opens (with the selected text) to search Mactuts+ — Kita sekarang akan mengubah URL yang dibuka PopClip (dengan teks yang dipilih) untuk mencari Mactuts+

Alamat pencarian ini adalah yang akan memperkuat extension kita. Di file Config, ubah String yang ada di bawah bagian untuk URL ke atas.

Langkah 5

Our icon that PopClip uses needs to be a 256px square with a transparent background and a solid area in black — Ikon kita yang digunakan PopClip harus berupa persegi 256px dengan background transparan dan area padat berwarna hitam

Dengan fitur pencarian utama yang dikonfigurasi, kita perlu menambahkan ikon. Ikon harus berupa PNG 256px transparan persegi. Untuk menghemat waktu, saya sudah memasukkan satu dengan file sumber yang dapat Anda download dan gunakan.

Tambahkan ikon ini (atau milik Anda) ke folder mactuts Anda. Saya telah menamai ikon yang saya berikan MactutsIcon.png.

Once we've added a new image, we need to update the Config file with the new name — Setelah menambahkan gambar baru, kita perlu memperbarui file Config dengan nama baru

Kembali ke file Config, kita perlu mengubah nama Image File ke yang sekarang digunakan.

Langkah 6

Finally, change the title of the extension and remove the "key" and "string" for "Regular Expression" — Terakhir, ubah judul extension dan hapus "key" dan "string" untuk "Regular Expression"

Ubah judul pop-up dari "Translate" ke "Mactuts+". Selain itu, hapus Key dan String yang terkait dengan Regular Expression. Ini adalah tambahan opsional yang tidak dibutuhkan.

Langkah 7

Extension kita sekarang siap untuk digunakan. Untuk mulai menggunakannya, kita perlu mengubahnya menjadi extension PopClip. Semua extension PopClip sebenarnya hanya folder bernama khusus. Tidak ada conversion tool atau command-line trickery yang dapat dilakukan.

Duplicate the folder we've been working with and rename it, adding ".popclipext" to the end — Gandakan folder yang telah dikerjakan dan ganti namanya, dengan tambahkan ".popclipext" di akhir

Pertama-tama, duplikat foldernya. Dengan folder yang baru diduplikasi, ubah nama menjadi mactuts.popclipext. Finder akan meminta Anda untuk mengonfirmasi bahwa Anda ingin mengganti nama.

You'll be asked if you're sure you want to add a file extension to the duplicated folder — Anda akan ditanya apakah Anda yakin ingin menambahkan extension file ke folder yang digandakan

4. Install dan Tes Extension

PopClip akan memperingatkan bahwa extension ini tidak ditandatangani, artinya extension itu tidak disetujui oleh developer. Karena masih baru, tidak apa-apa

Setelah dikonversi, klik dua kali file extension yang baru dibuat untuk menginstal. Anda akan menerima peringatan dari PopClip yang menjelaskan bahwa ini bukan extension yang disetujui. Jangan khawatir, ini hanya berarti bahwa kita ingin memasang extension yang bukan dari situs web developer. Konfirmasikan bahwa Anda ingin menginstalnya dan kemudian extension akan dipasang. Setelah dipasang, Anda akan melihatnya di daftar extensions yang telah diaktifkan PopClip. Di bagian bawah daftar adalah extensions Mactuts+ kita yang baru dikembangkan!

Once installed, PopClip will display our new extension in the menu — Setelah diinstal, PopClip akan menampilkan extension baru kita di menu

Sekarang untuk mengujinya. Highlight beberapa teks di mana saja dan ketika PopClip muncul, Anda sekarang akan melihat tampilan tombol pencarian Mactuts+ kita.

Selecting text will display the PopClip menu... along with our new extension! — Memilih teks akan menampilkan menu PopClip... bersama dengan extension baru kita!

Mengkliknya akan membuka tab atau jendela baru (atau bahkan meluncurkan) browser default Anda dan membuka langsung ke halaman hasil pencarian untuk apa yang Anda pilih.

When selected, PopClip will open a new tab with the selected text searched on Mactuts+ — Ketika dipilih, PopClip akan membuka tab baru dengan teks yang dipilih dicari di Mactuts+

Penutupan

Pada akhir tutorial ini, saya berharap Anda dapat belajar banyak dan mulai membuat extensions yang lebih maju. Halaman developer extension PopClip di GitHub memberi Anda kode sumber untuk semua jenis ekstensi sehingga Anda dapat melihat cara kerjanya.

Karena membangun extension untuk PopClip bisa sangat mudah, Anda mungkin tidak perlu menunggu seseorang mengembangkan extension yang Anda tunggu-tunggu, Anda mungkin bisa membuatnya sendiri!