راهنمای طراحی قالب وبلاگ و کدهای بلاگفا

کاربران بلاگفا این توانایی را دارند که علاوه بر امکان انتخاب قالب وبلاگ خود از فهرست قالبهای آماده در بلاگفا ، بر اساس سلیقه و نیاز خود شکل و قالب وبلاگ خود را تغییر دهند و یا قالب جدیدی برای وبلاگ خود طراحی کنند.
معمولا قالبهای وبلاگ مجموعه ای از کدهای HTML و بلاکها و کدهای مخصوصی هست که جایگاه عناصر مختلف وبلاگ مانند ایمیل، نام نویسنده یا نام وبلاگ را مشخص میکنند.هنگام مشاهده وبلاگ،خوانندگان به جای کدهای وبلاگ مقدار واقعی آنها (مثلا نام نویسنده) را خواهند دید.
تگها و کدهایی که بلاگفا آنها را پشتیبانی میکند به شرح زیر میباشد.

کدهای عمومی
این تگها را میتوانید در هر جایی از کد HTML قالب قرار دهید. توجه داشته باشید که بلاگفا نسبت به کوچکی و بزرگی حروف انگلیسی حساس است و بنابراین هنگام استفاده از آنها در نحوه تایپ آنها دقت کنید.

توضیح کد کد معرفی کننده نام کاربری وبلاگ. بطور مثال اگر آدرس وبلاگ demo.blogfa.com باشد ، نام کاربری آن demo میباشد. <-BlogId-> آدرس اینترنتی وبلاگ .مانند http://demo.blogfa.com <-BlogUrl-> نام صفحه نمایش دهنده محتوای XML وبلاگ که بصورت RSS میباشد.
مانند rss.aspx <-BlogXmlLink-> نام مدیر و نویسنده اصلی وبلاگ . مانند علیرضا <-BlogAuthor-> آدرس ایمیل نویسنده وبلاگ . توجه کنید که این با آدرس ایمیل خصوصی نویسنده وبلاگ متفاوت هست. مانند demo@yahoo.com <-BlogEmail-> توضیحات وبلاگ که معمولا معرفی کننده نویسنده و یا نوع مطالب وبلاگ است. <-BlogDescription-> عنوان وبلاگ . مانند وبلاگ آزمایشی <-BlogTitle-> نام صفحه آرشیو وبلاگ. مانند archive.aspx <-BlogArchiveLink-> فاصله زمانی از وقت گرینویچ. یکی از کاربردهای تنظیم تاریخ و زمان درج نظرات خوانندگان است <-BlogTimeZone-> کدهای HTML و اسکریپتهای خاص کاربر مانند اسکریپت ابزارهای آمار بازدیدکننده که در بخش تنظیمات وبلاگ وارد شده است <-BlogCustomHtml->

بلاک <BLOGFA>
بلاکها میتوانند شامل مجموعه از کدهای عمومی یا اختصاصی همان بلاک باشند. بلاک <BLOGFA> تعیین کننده جایگاه و نحوه نمایش مطالب وبلاگ است.این بلاک توسط کد <BLOGFA> شروع و توسط کد </BLOGFA> پایان می یابد.کدهای که تنها در این بلاک قابل استفاده هستند به شرح زیر میباشد.

توضیح کدهای استفاده شده در بلاک BLOGFA کد عنوان مطلب ارسال شده <-PostTitle-> متن کامل مطلب ارسال شده <-PostContent-> تاریخ ارسال یا تنظیم مطلب ( شکل و شیوه نمایش تاریخ در تنظیمات وبلاگ قابل تغییر است) <-PostDate-> زمان ارسال یا تنظیم مطلب ( شکل و شیوه نمایش زمان در تنظیمات وبلاگ قابل تغییر است) <-PostTime-> شماره شناسایی و مشخص هر مطلب <-PostId-> نام صفحه (لینک) هر مطلب که شامل اسم صفحه آرشیو ماه یا هفته و شماره شناسایی مطلب میباشد. <-PostLink-> کد یا شماره موضوع مطلب ارسال شده <-PostCategoryId->> عنوان موضوع مطلب ارسال شده <-PostCategory-> کد یا شماره نویسنده مطلب ارسال شده <-PostAuthorId-> عنوان نویسنده مطلب ارسال شده <-PostAuthor-> ایمیل نویسنده مطلب ارسال شده <-PostAuthorEmail-> لینک به صفحه آخرین مطالب نوشته شده توسط نویسنده مطلب <-PostAuthorLink->

بلاک <BlogComment>
این بلاک مشخص کننده شیوه نمایش تعداد یا متن توضیح نظرات هر مطلب ارسالی است.توجه کنید که استفاده از این بلاک تنها در بلاک <BLOGFA> مجاز و قابل استفاده هست. این میتوانید از اکثر کدهای عمومی و یا کدهای قابل استفاده در بلاک <BLOGFA> نیز استفاده کنید.همچنین محتوای این بلاک تنها در مواقعی نمایش داده خواهد شد که امکان درج نظر برای مطلب (post) توسط خوانندگان باشد.

بلاک <BlogExtendedPost>
این بلاک برای نمایش لینک ادامه مطلب یا متن کامل برای مطالب و پستهایی میباشد که دارای ادامه مطلب هستند. در صورتی که مطالبی دارای ادامه مطالب باشد محتوایت این بلاک نمایش داده خواهد شد. توجه کنید که استفاده از این بلاک تنها در بلاک <BLOGFA> مجاز و قابل استفاده هست.در این میتوانید از اکثر کدهای عمومی و یا کدهای قابل استفاده در بلاک <BLOGFA> نیز استفاده کنید.

بلاک <BlogArchive>
این بلاک مشخص کننده جایگاه آرشیو مطالب ماهانه یا هفتگی است.محتوای درون این بلاک به تعداد ماهها یا هفته های مطالب آرشیو شده تکرار میشود. همچنین شما میتواند تعیین کنید که تنها چند ماه یا هفته آخر نمایش داده شود. این کار نیز با تعیین خواصی برای این بلاک انجام شدنی است. برای نمونه اگر شما بلاک را به شکل زیر تعریف کنید.

<BlogArchive maxitems="6" archivetitle="دیگر صفحات" >

در اینصورت تنها شش ماه یا هفته آخر نمایش داده و در انتها لینکی به صفحه آرشیو با عنوان دیگر صفحات نمایش داده خواهد شد.در این بلاک کدهای زیر قابل استفاده هستند. البته میتواند از این بلاک بدون تعیین خواص نیز استفاه کنید. مانند <BlogArchive> ... </BlogArchive>

توضیح کدهای استفاده شده در بلاک BlogArchive کد عنوان آرشیو که با توجه به ماهانه یا هفتگی بودن شیوه آرشیو و تنظیمات وبلاگ نمایش داده میشود. مانند آذر 1383 <-ArchiveTitle-> مشخص کننده آدرس صفحه آرشیو ماه یا هفته. <-ArchiveLink->

بلاک <BlogLinks>
این بلاک مشخص کننده جایگاه و نحوه نمایش پیوندهای وبلاگ است.کدهای درون این بلاک به تعداد پیوندهای (لینکها) وارده شده توسط نویسنده وبلاگ تکرار خواهد شد.کدهای استفاده شده در این بلاک به شرح زیر است.

توضیح کدهای استفاده شده در بلاک BlogLinks کد عنوان پیوند . مانند سایت بلاگفا <-LinkTitle-> آدرس پیوند (URL) .مانند http://www.blogfa.com <-LinkUrl->

بلاک <BlogLinksBlock>
این بلاک به عنوان نگهدارنده بلاک <BlogLinks> می باشد و در حقیقت در صورتی که هیچ پیوندی ثبت نشده باشد محتوای این بلاک نمایش داده نمی شد. این مورد بخصوص در مواردی که مثلا پیوندها در یک جدول مخصوص نمایش داده می شود و می خواهید در صورتی که پیوندی وارد نشده جدول نیز نمایش داده نشود به کار می رود.

بلاک <BlogProfile>
این بلاک برای تعیین جایگاه و نحوه نمایش تصویر نویسنده وبلاگ و یا لوگو وبلاگ و همچنین توضیحاتی است که نویسنده وبلاگ درباره خود یا محتوای وبلاگ خود داده است.تمام کدها و محتوایی که داخل این بلوک باشد تنها موقعی نمایش داده خواهد که یا تصویر و یا توضیحات وبلاگ توسط نویسنده وبلاگ تعیین شده باشد.این بلوک همچنین میتواند شامل بلوک <BlogPhoto> نیز باشد.

توضیح کدهای استفاده شده در بلاک BlogProfile کد توضیحات در مورد نویسنده و یا وبلاگ <-BlogAbout-> بلاک تعیین کننده چگونگی نمایش تصویر یا لوگوی انتخابی برای وبلاگ <BlogPhoto>

بلاک <BlogProfileLinkBlock>
این بلاک و محتوای داخل آن تنها در صورتی نمایش داده خواهد که بخش پروفایل مدیر وبلاگ فعال شده بود. در این بلاک عموما لینک یا کد مخصوص لینک صفحه پروفایل قرار دارد. این بلاک کمک میکند که لینک صفحه پروفایل تنها زمانی در وبلاگ نمایش داده شود که بخش پروفایل توسط مدیر وبلاگ فعال شده باشد.

توضیح کدهای استفاده شده در بلاک BlogProfileLinkBlock کد آدرس صفحه پروفایل <-BlogProfileLink->

بلاک <BlogPhoto>
این بلاک برای تعیین چگونگی نمایش تصویر نویسنده وبلاگ و یا لوگو استفاده میشود.با توجه به این ممکن است کدهایی که برای نمایش یک تصویر در قالب وبلاگ بکار میرود در صورتی که کاربر تصویری را برای وبلاگ خود انتخاب نکند بدون استفاده باشند و حتی باعث بهم ریختگی شکل وبلاگ شوند. محتویات داخل این بلاک تنها وقتی نمایش داده می شود که نویسنده وبلاگ، تصویری را برای وبلاگ خود انتخاب کند.

توضیح کدهای استفاده شده در بلاک BlogPhoto کد لینک یا آدرس مستقیم تصویر تعیین شده برای وبلاگ توسط نویسنده <-BlogPhotoLink->

لازم به ذکر است که کدهای <-BlogAbout-> و <-BlogPhotoLink-> میتوانند در خارج از بلاکهای <BlogProfile>یا<BlogPhoto> نیز قرار گیرند و این بلاکها بیشتر برای محافظت از بهم ریختگی شکل نهایی وبلاگ در صورت تعیین نکردن تصویر یا توضیحات وبلاگ است.


بلاک <BlogLinkDump>
این بلاک مشخص کننده جایگاه و نحوه نمایش پیوندهای وبلاگ است.کدهای درون این بلاک به تعداد پیوندهای (لینکها) وارده شده توسط نویسنده وبلاگ تکرار خواهد شد.کدهای استفاده شده در این بلاک به شرح زیر است.

توضیح کدهای استفاده شده در بلاک BlogLinks کد عنوان پیوند . مانند سایت بلاگفا <-LinkTitle-> آدرس پیوند (URL) .مانند http://www.blogfa.com <-LinkUrl-> توضیحات وارد شده برای پیوند <-LinkDescription->

بلاک <BlogLinkDumpBlock>
این بلاک به عنوان نگهدارنده بلاک <BlogLinkDump> می باشد و در حقیقت در صورتی که هیچ پیوندی در بخش پیوندهای روزانه ثبت نشده باشد محتوای این بلاک نمایش داده نمی شد. این مورد بخصوص در مواردی که مثلا پیوندها در یک جدول مخصوص نمایش داده می شود و می خواهید در صورتی که پیوندی وارد نشده جدول نیز نمایش داده نشود به کار می رود.


بلاک <BlogCategories>
این بلاک مشخص کننده جایگاه و نحوه نمایش آرشیو موضوعی مطالب وبلاگ است.کدهای درون این بلاک به تعداد موضوعات تعریف شده توسط مدیر و نویسنده وبلاگ تکرار خواهد شد.کدهای استفاده شده در این بلاک به شرح زیر است.

توضیح کدهای استفاده شده در بلاک BlogCategories کد عنوان موضوع <-CategoryName-> آدرس صفحه آرشیو موضوع و نمایش آخرین مطالب مرتبط با این موضوع <-CategoryLink->

بلاک <BlogCategoriesBlock>
این بلاک به عنوان نگهدارنده بلاک <BlogCategories> می باشد و در صورتی که هیچ موضوعی برای مطالب وبلاگ تعریف نشده باشد محتوای این بلاک نمایش داده نمی شد. این مورد بخصوص در مواردی که مثلا موضوع در یک جدول مخصوص نمایش داده می شود و می خواهید در صورتی که موضوعی تعریف نشده جدول نیز نمایش داده نشود به کار می رود.


بلاک <BlogAuthors>
این بلاک مشخص کننده جایگاه و نحوه نمایش آرشیو و نام نویسندگان وبلاگ است.کدهای درون این بلاک به تعداد نویسندگان تعریف شده برای وبلاگ تکرار خواهد شد. کدهای استفاده شده در این بلاک به شرح زیر است.

توضیح کدهای استفاده شده در بلاک BlogAuthors کد نام نویسنده <-AuthorName-> آدرس صفحه آرشیو و نمایش آخرین مطالب نوشته شده توسط این نویسنده <-AuthorLink->

بلاک <BlogAuthorsBlock>
این بلاک به عنوان نگهدارنده بلاک <BlogAuthors> می باشد و در صورتی که نویسنده دیگری به غیر نویسنده اصلی مدیر وبلاگ تعریف نشده باشد محتوای این بلاک نمایش داده نمی شد. این مورد بخصوص در مواردی که مثلا نام نویسندگان در یک جدول مخصوص نمایش داده می شود و می خواهید در صورتی که نویسنده ای تعریف نشده جدول نیز نمایش داده نشود به کار می رود.


بلاک <BlogPreviousItems>
این بلاک مشخص کننده جایگاه و نحوه نمایش عناوین آخرین مطالب وبلاگ است.بصورت پیش فرض عناوین ده مطلب آخر وبلاگ نمایش داده خواهد شد با اینحال با تغییر در پارامتهای این بلاک میتوانید تعداد موارد نمایش داده شده را بین یک تا سی مورد تغییر دهید.برای نمونه کد زیر باعث نمایش عناوین پانزده مطالب آخر وبلاگ خواهد شد.

<BlogPreviousItems items="15" >

توضیح کدهای استفاده شده در بلاک BlogPreviousItems کد عنوان مطلب <-PostTitle-> تاریخ ارسال یا تنظیم مطلب ( شکل و شیوه نمایش تاریخ در تنظیمات وبلاگ قابل تغییر است) <-PostDate-> زمان ارسال یا تنظیم مطلب ( شکل و شیوه نمایش زمان در تنظیمات وبلاگ قابل تغییر است) <-PostTime-> شماره شناسایی و مشخص هر مطلب <-PostId-> نام صفحه (لینک) هر مطلب <-PostLink->

بلاک <BlogPreviousItemsBlock>
این بلاک به عنوان نگهدارنده بلاک <BlogPreviousItems> می باشد و در صورتی که هیچ مطلبی در وبلاگ وارد نشده باشد محتوای این بلاک نمایش داده نمی شد. این مورد بخصوص در مواردی که مثلا عناوین در یک جدول مخصوص نمایش داده می شود و می خواهید در صورتی که وبلاگ بدون مطلب باشد جدول نیز نمایش داده نشود به کار می رود.


بلاک <BlogNextAndPreviousBlock>
در آشیو زمانی،موضوعی یا نویسندگان تنها تعداد محدودی از آخرین مطالب نوشته شده در صفحه نمایش داده می شود و این تعداد در بخش تنظیمات وبلاگ قابل تغییر است اما این امکان وجود دارد که بقیه مطالب موجود در آرشیو در صفحات دیگری نمایش داده شوند. بلاک
<BlogNextAndPreviousBlock> نحوه نمایش لینکهای صفحات دیگر (مطالب قدیمی‌تر یا جدیدتر) را تعیین می‌کند. این بلاک فقط در صفحات آرشیو زمانی،موضوعی یا نویسندگان کاربرد دارد و در صفحه نخست وبلاگ یا آرشیوهایی که تعداد مطالب اندکی دارند نمایش داده نمی شود.

توضیح کدهای استفاده شده در بلاک <BlogNextAndPreviousBlock> کد یک بلاک زیرمجموعه برای نمایش صفحه قبلی (مطالب جدیدتر) <BlogPreviousPageBlock> یک بلاک زیرمجموعه برای نمایش صفحه بعدی (مطالب قدیمی‌تر) <BlogNextPageBlock> لینک صفحه قبلی (نمایش دهنده مطالب جدیدتر) <-BlogPreviousPageLink-> لینک صفحه بعدی (نمایش دهنده مطالب قدیمی‌تر) <-BlogNextPageLink->

نمونه ای از کدها و محتوای نمایش داده شده در <BlogNextAndPreviousBlock> به شکل زیر است.

<BlogNextAndPreviousBlock>
<div style="width:100%">
<BlogPreviousPageBlock>
<div style="width:49%;float:right;text-align:right"><a href="<-BlogPreviousPageLink->">مطالب جدیدتر</a></div>
</BlogPreviousPageBlock>
<BlogNextPageBlock>
<div style="width:49%;float:left;text-align:left"><a href="<-BlogNextPageLink->">مطالب قدیمی‌تر</a></div>
</BlogNextPageBlock>
</div>
</BlogNextAndPreviousBlock>

صفحات آرشیو
در بلاگفا برای هر بلاگ صفحه ویژه ای اختصاص داده شده است که فهرست صفحات آرشیو در آن نمایش داده میشود. شکل و طرح این صفحه نیز مانند قالب وبلاگ قابل تغییر است .البته در قالب آرشیو علاوه بر کدهای عمومی تنها بلاک <BlogArchive> قابل تعریف خواهد بود.


صفحات جداگانه
در بلاگفا کاربران می توانند صفحات جداگانه و متعددی را برای انتشار مطالب جدا از پستهای روزانه بسازند. بصورت پیش فرض محتوای این صفحات در قالب انتخابی یا قالب مشخص شده در بخش ویرایش قالب برای صفحات جداگانه نمایش داده می شوند. این بخش نیز دارای کدهای مختص خود است در ادامه اشاره شده است.

توضیح کدهای استفاده شده در قالب صفحات جداگانه کد عنوان وبلاگ همراه با عنوان صفحه <-BlogAndPageTitle-> عنوان صفحه <-BlogPageTitle-> آدرس اینترنتی صفحه <-BlogPageLink-> کد (بخشی از آدرس) صفحه که توسط کاربر مشخص شده <-BlogPageId-> محتوای اصلی صفحه که توسط کاربر مشخص شده است. در مورد صفحاتی که با امکان ویرایش کامل کد صفحه ایجاد شده است. این کد فعال نخواهد بود. <-BlogPageContent->

همچنین در صفحات جداگانه برخی از کدهای عمومی (مانند نام وبلاگ، توضیحات، درباره و...) نیز فعال هستند اما بلاکهای دیگر (مانند موضوعات، پیوندهای روزانه،عناوین پستهاو...) غیر فعال هستند.



در صورتی که به هر دلیلی بعد از تعریف قالب طراحی شده در نمایش صفحه اصلی یا آرشیو وبلاگ مشکلی پیش آمد و یا مطالب بصورت بهم ریخته نمایش داده شد احتمالا در بکارگیر کدها و بلاکها اشتباه شده است .
در ادامه نمونه ای بسیار ساده از ترکیب کدهای HTML و کدهای بلاگفا درج خواهد شد.

[PHP]


<HTML>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<BODY>
عنوان وبلاگ : <-BlogTitle-> <br>
آدرس وبلاگ :<-BlogUrl-> <br>
نام نویسنده:<-BlogAuthor-> <br>
توضیح وبلاگ:<-BlogDescription-> <br>

<BlogProfile>
تصویر نویسنده یا لوگوی وبلاگ:<br>
<BlogPhoto>
<img src="<-BlogPhotoLink->">
</BlogPhoto>
<br>
توضیحاتی در مورد نویسنده یا وبلاگ :<br>
<-BlogAbout->
</BlogProfile>

مطالب نوشته شده در وبلاگ: <br>
<BLOGFA>
عنوان مطلب:<-PostTitle-><br>
تاریخ ارسال مطلب:<-PostDate-><br>
متن مطلب:<br>
<-PostContent->
<br>
لینک کامل مطلب : <-BlogUrl-><-PostLink-> <br>

<BlogComment>
<script type="text/javascript">GetBC(<-PostId->);</script>
</BlogComment>
</BLOGFA>

آرشیو مطالب:<br>
<BlogArchive>
<a href="<-ArchiveLink->"><-ArchiveTitle-></a><br>
</BlogArchive>

</BODY>
</HTML>[/PHP]