راهنمای کدهای قالب بلاگ

راهنمای کدهای قالب بلاگ

کاربرانی که می‌خواهند قالب خود را ویرایش کنند، قالب جدیدی برای وبلاگ خود طراحی کنند یا قالبی را به blog.ir منتقل کنند،‌ نیاز به لیستی کامل از تگ‌های قابل استفاده در بلاگ.آی آر دارند. در اینجا لیست تقریبا کامل تگ‌ها و نحوه‌ی کار با آنها بیان شده‌است.

نکات کلی در مورد تگ‌ها

تگ‌ها در blog.ir در حالت کلی به دو دسته تقسیم می‌شوند:

تگ‌های ساده

تگ‌های ساده که به صورت تکی به کار می‌روند مانند (*post_title*) و (*blog_image*) و …

این تگ‌ها هنگام نمایش قالب به یک متن تبدیل می‌شوند، مثلا تگ اول به عنوان مطلب تبدیل می‌شود و تگ دوم به آدرس تصویر بلاگ.

دقت کنید که در برخی موارد این تگ‌ها می‌توانند خالی باشند، مثلا وقتی اگر سایتی تصویر بلاگ انتخاب نکرده باشد، تگ (*blog_image*) اصطلاحا خالی خواهد بود.

تگ‌های مرکب

تگ‌های مرکب،تگ‌هایی هستند که مانند تگ‌های html تگ باز و بسته دارند و داخل آنها می‌تواند متن و یا تگ‌های دیگر قرار بگیرد، مانند <box:menu> و </box:menu>. در این نوع تگ‌ها علامت / که قبل از نام تگ قرار می‌گیرد، نشان‌گر بسته شدن تگ می‌باشد.

در قالب‌های بلاگ سه نوع تگ مرکب وجود دارد:

تگ‌های box به شکل <box:xyz>

معمولا این تگ‌ها حالت شرطی دارند، یعنی محتوای داخل آن‌ها در شرایط خاص نمایش داده می‌شود.

مثلا در مورد تگ <box:menu> اگر یک وبلاگ منو نداشته باشد، محتوای داخل این تگ به کلی حذف شده و نمایش داده نمی‌شود.

یا مثلا تگ <box:post_detail> تنها زمانی نشان داده می‌شود که یک مطلب از بلاگ به صورت جدا در حال نمایش باشد (مثلا آدرس صفحه http://foo.blog.ir/post/bar باشد).

یا تگ <box:post_list> تنها زمانی نشان داده می‌شود که در حال نمایش لیست مطالب باشیم (مثلا صفحه اول بلاگ، یا صفحه لیست مطالب یک موضوع)

تگ‌های نمایش تکراری به شکل <view:xyz>

این تگ‌های برای نمایش تعدادی مورد (مثلا مطلب، موضوع، نظر، یک گزینه در منو) به کار می‌روند، و محتوای داخل آن‌ها به ازای هر مورد تکرار می‌شود.

مثلا تگ <view:post_list> ، در صفحه اول بلاگ برای نمایش لیست مطالب استفاده می‌شود و محتوای این تگ به ازای هر مطلب تکرار خواهد شد.

مثلا فرض کنید بلاگی، سه مطلب با عناوین my first post و my second post و my third post دارد. در این صورت حاصل نمایش قالب زیر:

<box:post_list>
    Here are my posts:
    <view:post_list>
        -- (*post_title*)
    </view:post_list>
</box:post_list>

به این شکل خواهد بود:

    Here are my posts:
        -- my first post
        -- my second post
        -- my third post

دقت کنید که اگر این بلاگ هیچ مطلبی نداشته باشد، کل محتوای تگ <box:post_detail> نمایش داده نمی‌شود (شامل عبارت Here are my posts).

تگ شرطی <check:if>

همانطور که گفته شد محتوای برخی از تگ‌ها می‌تواند خالی باشد (مثلا تگ (*blog_image*) وقتی کاربر تصویری برای بلاگ خود انتخاب نکرده باشد خالی است). با استفاده از این تگ می‌توان خالی یا تهی نبودن یک تگ را به شکل زیر چک کرد.

<check:if blog_image>
    blog image: <img src="(*blog_image*)">
</check:if>
<check:if not blog_image>
    This blog doesn't have image
</check:if>

مثلا در مثال بالا تگ <img> تنهای زمانی نشان داده می‌شود که بلاگ تصویر داشته باشد و در غیر این صورت متن جایگزین نمایش داده می‌شود. همان طور که در مثال مشخص است از <check:if not> می‌توان برای چک کردن خالی نبودن یک تگ استفاده کرد.