Widget Tags untuk Layouts
Tag <b:widget> dasar untuk menciptakan widget dijelaskan dalam Tags Elemen Halaman untuk Layouts. Jika Anda hanya ingin menggunakan tab Page Elements untuk bekerja dengan segala sesuatu, maka itulah semua yang perlu Anda ketahui. Namun, jika Anda menginginkan kontrol yang lebih halus, artikel ini menjelaskan apa yang dapat Anda masukkan ke dalam widget, jika Anda bekerja dalam mode "Expand Template Widget" dari halaman Edit HTML.
Hal pertama yang harus dilakukan adalah dengan menambahkan tag penutup. Jadi ini:
<b:widget [...attributes...] />
menjadi ini:
<b:widget [...attributes...]>
</ B: widget>
Sekarang dengan yang keluar dari jalan, mari kita bicara tentang apa yang Anda dapat menempatkan antara tag tersebut.
Termasuk
Widget konten yang terkandung dalam "includable" bagian, yang memiliki format ini:
<b:includable id='main' var='thiswidget'>
[Memasukkan konten apapun yang Anda inginkan di sini]
</ B: includable>
Atribut adalah sebagai berikut:
id: (Diperlukan) Sebuah pengenal unik terdiri dari huruf dan angka.
var: (Opsional) Sebuah identifier terdiri dari huruf dan angka, untuk referensi data dalam bagian ini. (Lihat bagian data di bawah ini.)
Layouts data Tags
Seperti disebutkan dalam Tags Widget untuk artikel Layouts, ada tag berbeda yang dapat Anda gunakan untuk memasukkan potongan khusus dari data dalam template Anda. Mereka semua akan diformat sebagai <data:name/> atau <data:name1.name2/>, dimana nama adalah nama dari bagian tertentu dari data yang ingin Anda gunakan. Dalam contoh name1.name2, name2 adalah barang tertentu dalam satu set data yang disebut name1, misalnya photo.url.
Ini adalah daftar induk dari semua data yang tersedia tersebut. Hal ini dibagi menjadi beberapa bagian oleh elemen halaman, karena berbagai jenis widget menggunakan data yang berbeda.
Secara global ada data
Page Header
Blog Tulisan
Blog Arsip
Profil
Teks / HTML / JavaScript
Makan
Gambar
Label
Daftar
Link List
Logo
Secara global ada data
Informasi ini berlaku untuk seluruh halaman, sehingga Anda dapat menggunakannya di mana saja, tidak seperti data lain yang hanya dapat digunakan dalam widget tertentu. Ini harus dirujuk sebagai bagian dari keseluruhan data "blog", misalnya sebagai <data:blog.title/>, dll
Judul: Judul blog.
pageType: Jenis halaman saat ini. Salah satu 'item', 'arsip', atau 'index'.
url: URL dari halaman saat ini.
homepageUrl: The homepage blog.
PAGETITLE: Judul dari halaman saat ini. Hal ini sering judul blog, tapi mungkin berisi informasi tambahan pada halaman arsip atau kirim.
encoding: The pengkodean digunakan untuk blog, misalnya UTF-8.
languageDirection: Entah "ltr" atau "rtl" untuk kiri-ke-kanan dan kanan-ke-kiri bahasa, masing-masing.
feedLinks: The link feed autodiscovery untuk header halaman.
Kembali ke atas.
Page Header
Ini adalah sebuah widget sederhana dengan hanya dua lembar data. Mereka dapat dirujuk hanya sebagai <data:title/> dan <data:description/>.
Judul: Judul blog.
description: deskripsi blog.
Kembali ke atas.
Blog Tulisan
Ini adalah bagian tengah dari blog apapun, dan yang paling kompleks. Anda pasti harus mempertimbangkan hanya membuat modifikasi ke salah satu template default sebelum menulis widget posting blog dari awal. Tapi bagaimanapun Anda ingin melakukannya, inilah semua data yang tersedia di widget ini.
feedLinks: Daftar feed untuk halaman ini. Di halaman utama, hal ini akan berisi feed blog utama, pada halaman item, ini juga akan berisi feed komentar. Setiap item dalam daftar ini berisi berikut:
url: The URL feed.
Nama: Nama pakan (yakni 'Tulisan' atau 'Komentar').
feedType: Jenis pakan (Atom atau RSS).
Mimetype: Jenis mime pakan.
olderPageUrl: Jika ada posting lama daripada yang di halaman ini, ini adalah URL untuk mereka posting. Konteks-sensitif untuk jenis halaman. (Tidak semua halaman akan memiliki link ini.)
olderPageTitle: Judul dari link ke halaman posting yang lebih tua.
newerPageUrl: Setara baru dari olderPageUrl.
newerPageTitle: Setara baru dari olderPageTitle.
commentLabel: Ungkapan yang digunakan untuk menunjukkan jumlah komentar, misalnya "Komentar."
authorLabel: Ungkapan digunakan untuk menunjukkan yang menulis posting, misalnya "Diposting oleh."
timestampLabel: Ungkapan yang digunakan untuk menunjukkan bila pos itu ditulis, misalnya "Diposting di."
postLabelsLabel: Frase untuk memperkenalkan daftar label posting, misalnya "Label untuk posting ini."
backlinksLabel: Frase untuk menggambarkan backlink ke posting ini, misalnya "Link ke posting ini."
posting: Sebuah daftar semua posting untuk halaman ini. Masing-masing pos berisi berikut:
dateHeader: Tanggal posting ini, hanya hadir jika ini adalah posting pertama dalam daftar yang telah diposting pada hari ini.
id: ID pasca numerik.
Judul: Judul tulisan tersebut.
Tubuh: Isi dari pos.
Penulis: Nama tampilan penulis posting.
url: The permalink dari posting ini.
timestamp: The timestamp posting. Berbeda dateHeader, ini ada untuk setiap posting.
label: Daftar label tulisan tersebut. Setiap label berisi berikut:
Nama: Teks label.
url: URL dari halaman yang berisi daftar semua tulisan dalam blog ini dengan label ini.
isLast: Benar atau salah. Apakah label ini adalah yang terakhir dalam daftar (berguna untuk menempatkan koma).
allowComments: 'Benar' jika posting ini memungkinkan komentar.
numComments: Jumlah komentar pada posting ini.
showBacklinks: Apakah menampilkan link balik untuk posting ini.
numBacklinks: Jumlah backlink untuk posting ini.
addCommentUrl: URL dari 'menambahkan komentar' bentuk untuk posting ini.
emailPostUrl: URL dari bentuk 'email ini posting' untuk posting ini.
editUrl: URL dari bentuk edit untuk posting ini.
feedLinks: Daftar feed khusus untuk posting ini. (Hal ini berbeda dari feedLinks blog keseluruhan, karena mungkin berisi umpan untuk komentar tulisan tersebut, misalnya.) Setiap berisi berikut:
url: The URL feed.
Nama: Nama pakan (misalnya 'Tulisan' atau 'Komentar').
feedType: Jenis pakan (Atom atau RSS).
Mimetype: Jenis mime pakan.
Komentar: Sebuah daftar semua komentar untuk posting ini (pada halaman item saja). Masing-masing berisi berikut:
id: ID numerik komentar.
Tubuh: Tubuh komentar.
timestamp: Waktu komentar diciptakan.
Penulis: Nama tampilan penulis komentar, atau 'Anonymous'.
authorUrl: URL profil penulis komentar, jika komentar tidak anonim.
deleteUrl: URL untuk menghapus komentar ini.
isDeleted: Apakah komentar ini telah dihapus. (Teks komentar dihapus diganti dengan pengganti.)
Kembali ke atas.
Blog Arsip
Gaya yang berbeda tersedia di sini adalah untuk pilihan default yang berbeda pada tab Page Elements. Jika Anda sedang merancang sebuah versi baru, itu termudah untuk menggunakan 'FLAT' sebagai gaya, dan kemudian memanipulasi sisa data yang diinginkan.
Judul: Judul widget.
style: Salah satu 'MENU', 'FLAT', atau 'HIRARKI'.
Data: Daftar setiap unit arsip, masing-masing berisi:
Nama: Nama interval arsip, misalnya "Agustus 2006."
url: The link ke halaman yang berisi tulisan dari interval ini.
pasca-count: Berapa banyak posting yang ada di dalam interval ini.
Kembali ke atas.
Profil Widget
Untuk blog dengan penulis tunggal, widget profil berisi informasi berikut. Perhatikan bahwa untuk mengakses bagian-bagian yang berbeda dari data foto, Anda akan menggunakan notasi seperti <data:photo.url/>.
Judul: Judul widget.
userUrl: URL profil penulis.
Lokasi: Lokasi dari profil penulis.
aboutme: The "About Me" informasi dari profil.
DisplayName: nama tampilan penulis.
foto: foto profil user, terdiri dari sebagai berikut:
url: The URL foto.
Lebar: Lebar foto itu, dalam piksel.
height: Ketinggian foto itu, dalam piksel.
alt: The "alt" teks untuk foto.
Pada blog tim, widget profil berisi sedikit informasi tentang penulis lebih, sebagai berikut.
Judul: Judul widget.
Penulis: Daftar semua penulis, yang masing-masing berisi berikut:
DisplayName: nama tampilan penulis.
userURL: URL profil penulis.
Jika Anda ingin merancang template Anda untuk menangani kedua blog tunggal dan multiple-penulis, Anda dapat menggunakan data: variabel tim untuk membedakan antara dua kasus. Misalnya <b:if cond='data:team=="true"'> (menampilkan beberapa penulis) </ b: if>
Kembali ke atas.
Teks / HTML / JavaScript Widget
Widget Teks dan HTML / JavaScript widget bekerja dengan cara yang sama dan memiliki dua buah data yang sama.
Judul: Judul widget.
isi: Isi widget.
Kembali ke atas.
Pakan Widget
Sebuah umpan konten widget ini secara dinamis dimuat menggunakan Google AJAX API setelah blog yang diberikan dalam browser. Hal ini dapat ditata hanya menggunakan CSS.
Judul: Judul widget.
feedUrl: URL dari feed.
Kembali ke atas.
Gambar Widget
Sebuah widget gambar berisi gambar tunggal, dan menyediakan semua data yang relevan untuk gambar itu.
Judul: Judul widget.
sourceUrl: URL gambar.
Lebar: Lebar gambar itu, dalam piksel.
height: Ketinggian gambar itu, dalam piksel.
caption: The caption gambar.
Kembali ke atas.
Label Widget
Widget label berisi daftar semua label yang sedang digunakan di blog.
Judul: Judul widget.
label: Daftar label, masing-masing berisi:
Nama: Teks label.
menghitung: Berapa banyak posting memiliki label ini.
url: Sebuah link ke halaman yang menampilkan posting dengan label ini.
Kembali ke atas.
Daftar Widget
Bentuk paling sederhana dari daftar. Setiap item hanya satu bagian dari teks, tanpa berbagai jenis data di dalamnya.
Judul: Judul widget.
item: Daftar item.
Kembali ke atas.
Link Daftar Widget
Sebuah daftar yang sedikit lebih menarik, di mana setiap item memiliki dua bagian itu: teks dan link.
Judul: Judul widget.
Link: Daftar link, masing-masing berisi:
Nama: teks link.
Target: URL link.
Kembali ke atas.
Logo Widget
Tidak mendapatkan sederhana dari satu ini. Hanya satu bagian dari data di sini.
fullButton: URL dari tombol Blogger yang telah Anda pilih
Setiap widget harus memiliki satu includable dengan id = 'main'. Hal ini biasanya akan berisi sebagian besar atau semua konten yang akan ditampilkan untuk widget ini, dan dalam banyak kasus akan semua yang Anda butuhkan.
Jika Anda membuat includables lebih dengan ID berbeda, mereka tidak akan ditampilkan secara otomatis. Namun, jika Anda membuat includable dengan id = 'baru', maka Anda dapat referensi dalam includable utama Anda dengan <b:include name='new' /> dan akan menampilkan seperti itu.
Atribut untuk b: include tag adalah sebagai berikut:
Nama: (Diperlukan) Sebuah identifier terdiri dari huruf dan angka. Ini harus sesuai dengan ID dari sebuah b ada: includable dalam widget yang sama.
Data: (Opsional) Sebuah ekspresi atau suatu bagian data untuk meneruskan ke bagian includable. Ini akan menjadi nilai atribut var dalam includable.
Berikut ini adalah contoh sederhana yang menunjukkan penggunaan b: includable dan b: termasuk. Loops dan data yang dijelaskan nanti dalam artikel ini. Hal utama untuk memahami di sini adalah bagaimana "utama" bagian meliputi "pos" bagian di dalamnya. Ini melewati sepanjang pos yang mereka sebut "i" dan referensi bagian disertakan sebagai var nya "p", kemudian mencetak judul.
<b:includable id='main'>
<b:loop var='i' values='posts'>
<b:include name='post' data='i'/>
</ B: loop>
</ B: includable>
<b:includable id='post' var='p'>
Judul: <data:p.title/>
</ B: includable>
Termasuk yang paling berguna jika Anda memiliki bagian dari kode yang Anda ingin mengulang beberapa kali di tempat yang berbeda. Anda hanya dapat menulis kode sekali, memasukkannya ke dalam ab: includable, kemudian gunakan b: include di manapun Anda inginkan untuk muncul. Jika Anda tidak perlu melakukan itu, maka Anda hanya dapat menempel dengan includable utama tunggal dan tidak khawatir tentang sisanya. (Perhatikan bahwa includable utama termasuk automically - <b:include name='main'/> tidak diperlukan.)
Data
Data: tag ini bisa dibilang salah satu yang paling penting, karena itu adalah jalan yang membawa semua konten Anda yang sebenarnya. Beberapa contoh dari tag ini adalah:
<data:title/>
atau
<data:photo.url/>
Contoh pertama adalah sederhana, dan akan bekerja di widget kebanyakan, karena widget yang paling memiliki judul. Semua hal ini adalah mencetak judul widget. Contoh kedua menunjukkan variabel yang lebih kompleks, dari mana kita memilih komponen tertentu. Sebuah foto, mengatakan dalam konteks widget profil, mungkin memiliki komponen seperti url, tinggi, dan lebar. Menggunakan "." notasi menunjukkan bahwa kita ingin URL untuk foto ini, bukan URL dari sesuatu yang lain.
Ada banyak data yang dapat Anda akses dengan data: tag, dan bervariasi tergantung pada widget Anda bekerja dengan. Kami punya daftar lengkap untuk membantu Anda menemukan data yang Anda butuhkan.
Loops
B: tag lingkaran memungkinkan Anda mengulangi bagian dari isi beberapa kali. Hal ini paling sering digunakan untuk mencetak setiap posting dalam daftar posting untuk halaman yang diberikan, atau setiap komentar, atau setiap label, dll Format umum untuk menggunakan loop ini:
<b:loop var='identifier' values='set-of-data'>
[Isi ulang dimasukkan di sini]
</ B: loop>
Bagian 'identifier' dapat nama apapun yang Anda pilih, dan akan digunakan untuk berdiri di untuk setiap item baru dalam daftar, setiap kali melalui loop. Sebuah konvensi umum adalah untuk hanya menyebutnya "i". Himpunan data yang Anda tentukan untuk nilai-nilai dapat berupa bagian dari data yang dijelaskan dalam artikel tag Data sebagai daftar item. Misalnya, dalam widget posting blog, posting adalah daftar. Kode seperti loop kehendak berikut melalui pos masing-masing, mencetak judul untuk masing-masing, dengan tag header di sekitarnya.
<b:loop var='i' values='data:posts'>
<h2> <data:i.title/> </ h2>
</ B: loop>
Perhatikan bagaimana "i" mengambil nilai dari setiap posting pada gilirannya, sehingga Anda bisa mendapatkan judul dari masing-masing.
Jika / Lain
Anda dapat menggunakan b: jika dan b: tag lain untuk menampilkan konten di beberapa tempat tetapi tidak yang lain. Format umum adalah ini:
<b:if cond='condition'>
[Konten untuk menampilkan jika kondisi benar]
<b:else/>
[Konten untuk menampilkan jika kondisi adalah palsu]
</ B: if>
B: tag lain adalah opsional. Tanpa itu, hasilnya akan berupa isi yang tercantum dalam b: jika bagian atau tidak. Penutup </ b: if> diperlukan dalam setiap kasus, namun.
Untuk "Kondisi" Anda dapat dimasukkan ke dalam sesuatu yang mengevaluasi untuk bisa benar atau salah. Beberapa tag data nilai hanya benar / salah pada mereka sendiri, misalnya allowComments pada posting. Dengan potongan data lain, Anda dapat membandingkan mereka dengan nilai-nilai tertentu untuk mendapatkan benar atau salah. Berikut adalah beberapa contoh:
<b:if cond='data:post.showBacklinks'> Benar jika pos saat ini diatur untuk menampilkan link balik.
<b:if cond='data:blog.pageType == "item"'> Benar jika halaman saat ini merupakan halaman item (halaman posting).
<b:if != cond='data:displayname "Fred"'> Benar jika ini bukan nama tampilan Fred.
<b:if cond='data:post.numComments> 1 '> Benar jika pos saat ini memiliki lebih dari satu komentar.
