Konfigurasi Dan Basic Dasar StupidPie

Tutorial pertama dari StupidPie 101

Konfigurasi Dan Basic Dasar StupidPie

Tulisan di gambar ini pasti sudah tidak asing lagi buat spp-ers sekalian, sepenggal kode itu adalah hal inti dalam konfigurasi dan basic dasar stupidpie. Kode tersebut bertanggung jawab untuk menegaskan bahwa pada ‘template‘ ini, kita akan membutuhkan variabel apa yang nantinya akan tampil di page blog kita. Selain itu, konfigurasi template stupidpie juga membutuhkan hal lain untuk memberi ciri khas atau keunikan pada hasil akhir nya nanti, seperti yang dijelaskan disini.

Terus apa sih arti dari kode – kode tersebut? Mungkin ada beberapa yang benar benar mengerti dan hapal arti dari masing – masing kode yang ada di konfigurasi dan basic dasar template stupidpie, tapi tidak ada salahnya bagi yang belum mengerti untuk mencari tau di artikel ini.

Perhatian! Materi yang ada di artikel ini adalah murni hasil pemahaman gw sendiri, jadi ini bersifat subjektif ya, mohon dimaafkan kalau ada yang salah atau kurang benar, kalau ada yang mau sumbang detail nya juga sangat membantu, bisa comment di artikel ini langsung.

Daftar dan Fungsi dari Konfigurasi StupidPie

List tidak dibuat secara urutan apapun, silahkan gunakan ctrl+f untuk pencarian.

Dibaca seperti berikut ini: Fungsi <new line> Keterangan

{% fungsi %} atau {{ fungsi | atribut }}

Keterangan

Sudah cukup jelas yah, oke mari kita mulai mengenal konfigurasi dan basic dasar stupidpie!

– Fungsi inti pada setiap template.

{% api %} atau {% image %} atau {% video %} atau {% mp3 %}

Menegaskan bahwa pada template ini, salah satu atau semua variabel akan digunakan. Kode {% api %} untuk variabel yang berisi hasil dari google search, yang lain nya sesuai dengan namanya masing – m-asing. Supaya aman, boleh di tulis semua walaupun nantinya tidak digunakan(Kalau tidak di tulis, begitu di panggil akan output error).

– Fungsi untuk memeriksa hasil parse.

{% if have_results %} atau {% if have_images %} atau {% if have_videos %} atau {% if have_mp3 %}

Memastikan sebelumnya bahwa variabel yang kita panggil benar – benar ada hasilnya.

  • {% if have_results %} – memastikan untuk fungsi {% api %}
  • {% if have_images %} – memastikan untuk fungsi {% image %}
  • {% if have_videos %} – memastikan untuk fungsi {% video %}
  • {% if have_mp3 %} – memastikan untuk fungsi {% mp3 %}

Jangan lupa setiap ada kata if maka kita akan butuh sesuatu untuk mengakhiri nya, kode yang digunakan di stupidpie adalah {% endif %}

– Fungsi untuk menentukan nama perwakilan, pada variabel.

{% for index, $var in $function %}

$var disini bisa diganti dengan apapun, digunakan sebagai nama ganti untuk item di variabel fungsi.
$function adalah fungsi yang kita panggil dan sudah kita pastikan tadi, contohnya bila kita menggunakan kode {% if have_results %}, maka kode nya akan terlihat seperti ini {% for index, $var in api %}.

Tujuan dari kode ini adalah untuk menunggalkan item dari variabel fungsi yang kita panggil, karena for digunakan saat kita akan memulai sebuah loop.

Contohnya: {% for index, result in api %}

Nah sekarang setiap item dari variabel fungsi api di wakilkan oleh result.

Penggunaannya seperti ini: {{ result.0.title }}, {{ result.2.description }} akan menghasilkan kalimat Title dari item nomor 1, Deskripsi dari item nomor 3.

Sampai tahap ini, gpp kalau belum sepenuhnya mengerti sama penjelasan di atas, cukup diingat dulu.

Baca juga:   Best Combo! AGC Dojo Plus WP Automatic

Jangan lupa setiap ada kata for dalam fungsi, seperti if yang sebelumnya dijelaskan, kita juga butuh kode untuk mengakhirinya, kali ini kode nya adalah {% endfor %}

– Fungsi untuk menentukan jumlah variabel yang kita ingin gunakan.

{% if index < 1 %} atau {% if index < 5 %} atau {% if index == 9 %} 
digunakan setelah {% for index, $var in $function %}

Ini adalah kode yang menentukan jumlah item yang akan kita gunakan, dan juga urutan sebuah item bila menggunakan ‘==’ sebagai tanda nya.

Contoh: {% for index, img in images %} {% if index < 5 %} maka akan menampilkan img.0, img.1, img.2, img.3, dan img.4 dan output nya nanti tergantung dengan kode html kita masing – masing.

Jangan lupa setiap ada kata if maka kita akan butuh sesuatu untuk mengakhiri nya, kode yang digunakan di stupidpie adalah {% endif %}

– Fungsi di ikuti dengan atribut.

{{ $var | $attribut }}

Kode ini digunakan di dalam kode template stupidpie kita. Fungsinya adalah pengganti sebuah attribut dari yang aslinya sesuai dengan aturan html yang berlaku.

Bagi yang belum sempat belajar HTML, singkatnya setiap gambar/video/iklan/dkk yang kita lihat di sebuah website itu semuanya disusun dalam sebuah kode HTML, juga disebut element. Setiap element memiliki atribut masing – masing dan inilah yang jadi tugas stupidpie(Untuk sedikit contoh dan fungsi dasar stupidpie bisa cek disini).

Melanjutkan contoh yang sebelumnya, bila di aplikasikan pada kode HTML, maka kira kira akan jadi seperti ini:

<img alt="{{ img.0.title | capitalize }}" src={{ img.0.mediaurl }} />



<caption>{{ img.0.title | capitalize }}, {{ img.0.size }}


<caption>

Dan hasil akhirnya akan tampil seperti ini:

Variabel Dan Attribute Di Dalam Konfigurasi StupidPie
Pada contoh tersebut, gambar yang kita gunakan adalah gambar nomor 1 dari hasil pencarian(nomor urut dimulai dari 0, bukan 1)

List lengkap atribut bisa dicek di akhir post, untuk mengingat kembali apa aja yang udah dibaca dari atas 🙂

Rangkuman Sejauh Ini

Jadi kesimpulan dan hasil akhir yang kita pelajari dari apa yang ada di post ini bila di aplikasikan akan jadi seperti ini:


{% api %}{% image %}{% video %}{% mp3}

{% if have_results %}

{% for index, item in api %}

{% if index < 2 %}

{{ '{Topik|Cerita|Artikel|Info}' | spin }} seputar kejadian mengenaskan kemarin yaitu {{ item.0.title | lower }} bila disimpulkan secara singkat adalah


<ul>


<li>{{ item.0.description | capfirst }}.</li>




<li>{{ item.1.description | capfirst }}.</li>


</ul>


{% endif %}

{% endfor %}

{% endif %}

Coba lihat {{ '{foto|gambar}' | spin }} yang berhasil kami dapatkan secara eksklusif:

{% if have_images %}

{% for index, img in images %}

{% if index == 1 %}

<center><img src="{{ img.mediaurl }}" alt="{{ img.title | capitalize }}" />
{{ img.title | capitalize }}, {{ img.size }}&nbsp;

</center>{% endif %}

{% endfor %}

{% endif %}

<strong>Warning!</strong> Video berikut mengandung unsur kekejaman, kebijakan penonton sangat disarankan.

{% if have_videos %}

{{ videos.0.videoid | videoplayer | safe }}

{% endif %}

Itu sekedar contoh, dan tidak disarankan untuk digunakan. Tapi semoga bagi yang sudah mengikuti dari awal sampai akhir, kode konfigurasi dasar stupidpie di atas udah ga bingung lagi darimana asal muasalnya ^^

Baca juga:   Penempatan Kode SPP Dan Alasannya

New update 07 Februari 2016

Update ini sebagian besar bersifat advance atau boleh dibilang, “kalau belum mengerti 100% lebih baik jangan digunakan”.

– Fungsi ‘str_replace‘ untuk mengganti keseluruhan.

{{ $var | str_replace '$cari', '$timpa' }}

Atribut str_replace seperti yang dicontohkan di atas, digunakan saat kita ingin mengganti keseluruhan dari $var, hanya bila $var mengandung $cari.

Nah tolong dipahami baik – baik kalimat di atas ya, agak njelimet tapi kalau di baca pelan – pelan pasti bisa ngerti kok 🙂

– Fungsi untuk memanggil spp, dari dalam template.


{% spp :term $templatespp $hackspp %}

{{ spp | safe }}

Bagi yang belum tau, sebenarnya kita bisa memanggil kode spp dari dalam template, tanpa harus mengubah atau menambah kode spp manual pada file di tema kita. Fungsi ini pertama kali gw liat di SPP versi 2 ke atas.

Walaupun fungsi ini tersedia, sekali lagi ditekankan bahwa penggunaan nya jarang sekali kalau untuk template – template pada umum nya.

Bila dijabarkan, fungsi di atas kurang lebih sama dengan:


<?php

$keyword = 'term';

$template = $templatespp;

$hack = $hackspp;

/* dan untuk {{ spp | safe }} */

echo spp($keyword, $template, $hack);

?>

Paham ya? Oke lanjut..

– Fungsi ‘strtr’ untuk mengganti kata berdasar jumlah huruf.


{{ $var | strtr '$from', '$to' }}

Atribut strtr gunanya untuk mengubah kata (dalam php, disebut juga translate), dan $to hanya akan menggantikan sesuai jumlah total huruf $from.

Oke, contoh kasar nya aja begini:

{{ aku anak sehat yg juga kuat | strtr ‘yg’, ‘yang’ }}

Fungsi di atas, akan menghasilkan kalimat:

aku anak sehat ya juga kuat

Perhatikan pada kata ‘yg’ dan di kalimat kedua berubah menjadi ‘ya’. Walaupun kita menuliskan ‘yang’ sebagai pengganti ‘yg’, tapi karena ‘yg’ hanya memiliki 2 huruf, maka gantinya pun hanya 2 huruf awal saja. Silahkan digunakan dan dikreasikan sendiri setelah tau arti dan kegunaan fungsi ini.

– Fungsi untuk menormalkan html entities.


{{ &#x3C; &#x3E; | html_entity_decode }}

Fungsi yang satu ini, sangat berguna apabila menggunakan tutorial ini karena sering sekali kita akan menjumpai ‘html entities‘ pada feed page. Dengan adanya atribut ‘html_entity_decode’, kita ga usah khawatir sama output seperti ini: &#x2122; atau &#xB2;

Btw &#x3C; &#x3E; adalah ‘<‘ dan ‘>’, sedangkan &#x2122; adalah ‘™’, dan &#xB2; adalah ‘²’.

Sekian update kali ini.

Daftar Atribut StupidPie

  1. spin = Mengolah $var spun text (lebih lanjut nya nanti).
  2. remove = Menghilangkan sebuah pola dari $var.
  3. get_video_id = Mengambil video ID dari $var.
  4. trim = Menghilangkan spasi atau tab sesudah atau sebelum $var.
  5. capitalize = Mengganti huruf pertama dari $var menjadi huruf kapital.
  6. build_permalink_for = Mengubah $var menjadi URL sesuai dengan settingan permalink pada stupidpie.
  7. remove_common_words = Menghilangkan sebuah kata dari $var sesuai dengan settingan pada stupidpie.
  8. str_replace = Mengganti secara keseluruhan, bila mengandung kata/huruf/angka yang di deklarasikan terlebih dahulu.
  9. safe = Menyatakan fungsi yang di input aman untuk di proses melalui HTML.
  10. strtr = Menggantikan kata, sesuai dengan jumlah huruf yang dimiliki.
  11. html_entity_decode = Menormalkan html entities yang terdapat pada $var.

Lanjutkan yah di post berikutnya mengenai penempatan kode SPP…

One comment

  • Hello, guest