راهنمای متغیر های ویبولتین ( Stylevars ) – VBulletin -Stylevars :
باسلام ، با یک مقاله آموزشی ویبولتین دیگر در خدمت شما دوستان و همراهان گرامی هستیم ، در این مقاله آموزشی قصدا داریم به معرفی راهنمای متغییر های ویبولتین یا همان Styletvar های ویبولتین بپردازیم :
در این مقاله می خوانید :
راهنمای متغیر های ویبولتین ( Stylevars ) چیست ؟ :
قبل از این که بخواهیم به Stylevar های ویبولتین بپردازیم شاید بهتر باشه که بدانید اصلا Stylevar در ویبولتین به چه معناست :
استایل وار (Stylevar) هست یک کد کوتاه برای متغیر های ویبولتین ، این مجموعه از متغیر ها ایجاد شده اند برای مدیریت اسان تر استایل در وببولتین ، استایل وار ها میتوانند روی مسیر تصاویر – (image paths) – عرض انجمن ها و دیگر جنبه های ویبولتین مدیریت داشته باشند
یا ساده تر به متغیر های ویبولتین ، استایل وار – (Stylevar) گفته می شود که از ان ها میتوانید در استایل های ویبولتین استفاده کنید – نمونه :
[php] {vb:var variable} [/php]نحوه دسترسی به متغیر ها در ویبولتین :
نحوه دسترسی به استایل وار ها – Stylevars : برای دسترسی به متغیر های ویبولتین ، هر کجا که بخواهید از انها استفاده کنید باید از دستوری مثل ، دستور زیر استفاده کنید :
[php] {vb:var variable} [/php]دسترسی و اجرا کردن متغیر ها به این روش شیوه ای امنی می باشد برای دسترسی به خروجی htmlspecialchars ها در ویبولتین :
برای دسترسی به عناصر ارایه در متغیر های ویبولتین – stylevar ها ، از عملگر نقطه به جای براک در پی اچ پی استفاده میشود – نمونه :
[php] {vb:var variable.foo} // accesses htmlspecialchars($variable[‘foo’]){vb:var variable.$varkey} // accesses htmlspecialchars($variable[$varkey])
[/php]
متغیر های اولیه ویبولتین :
برای دسترسی به متغیر ها در حالت عادی در ویبولتین 4 از دستور زیر استفاده میکنیم :
[php] {vb:var variable} [/php]فرم دستورات متغیر های ویبولتین :
راهنمای متغیر های ویبولتین ( Stylevars ) – فرم دستورات – فرم کلی متغیر های ویبولتین به صورت زیر می باشد :
[php] {vb:method variable} [/php]انواع متدها :
1) متد phrase : این متد به طور کلی برای متغیر های زبان در ویبولتین کاربرد دارد
شیوه نامه کلی :
[php]{vb:phrase phrase_name}[/php]مثال :
[php]{vb:phrase welcome}[/php]که این متغیر در نهایت پیغام خوش آمد گویی را چاپ می کند ، از این گونه متغیر ها میتواند در جاهای مختلف استفاده کرد مثلا : برای کاربر (علیرضا) عزیز خوش آمدید میتوان از چنین کدی استفاده کرد :
[php] کاربر گرامی (علیرضا) عزیز {vb:phrase welcome}[/php]
که در جلوتر متد های دیگری را نیز معرفی خواهیم کرد که میتوان با ان نام کاربری اعضا را چاپ کرد.
2) متد rawphrase : این متد نیز به طور کلی برای متغیر های زبان در ویبولتین کاربرد دارد البته تفاوت هایی با متد phrase دارد که در اموزش های بعدی به آن اشاره خواهیم کرد .
شیوه نامه کلی :
[php]{vb:rawphrase phrase_name}[/php]مثال :
[php]{vb:rawphrase message_by_x_on_y_at_z,}[/php]3) متد date : این متد برای نمایش زمان کاربرد دارد
مثال :
[php]{vb:date timestamp}[/php]4) متد time : این متد نیز برای نمایش زمان کاربرد دارد که البته با متد date تفاوت هایی دارد که در اینده به ان اشاره خواهیم کرد
مثال :
[php]{vb:time timestamp}[/php]5) متد number : این متد برای نمایش اعداد در ویبولتین کاربرد دارد
[php]{vb:number number}[/php]6) متد raw : این متغیر برای چاپ متغیر خام بدون هیچ گونه تغییر و قالب کاربرد دارد
مثال :
[php]{vb:raw variable}[/php]7) متد escapejs : یک نوع متد برای کد های جاوا اسکریپت هست که به دلیل این که کمتر با ان کار خواهید داشت صرفا برای اشنایی شما نام ان را اوردیم که در ادامه جهت اشنایی بیشتر با آن یک مثال هم برایتان می آوریم :
مثال :
[php]{vb:escapejs variable}[/php]8) متد urlencode : نوعی متد برای ادرس دهی هست ، که این متد هم مانند مثال قبلی کمتر با ان کار خواهید داشت
مثال :
[php]{vb:urlencode variable}[/php]9) متد if : این متد برای ایجاد شرط در ویبولتین کاربرد دارد ، که یکی از مهم ترین متد های ویبولتین هست .
شیوه نامه کلی :
[php]{vb:if condition, true[, false]}[/php]مثال :
[php]<div class="{vb:if $forumid==1, forum1, forum}">…</div>
[/php]البته این متد ها مثل متد if زیر مجموعه هایی هم دارند که در اینده آن ها را بررسی خواهیم کرد.
10) متد لینک link در ویبولتین : این متد برای چاپ لینک های ویبولتین کاربرد دارد ،مثلا میتوان با ان لینک یک انجمن را چاپ کرد ، که میشه گفت این نوع مند هم جز یکی از مهم ترین متد های ویبولتین هست .
مثال :
[php]{vb:link type, info[, extra-info]}[/php]11) متد math : این متد بیشتر در css استفاده می شود و برای ارزیابی عبارات ریاضی کاربرد دارد
مثال :
[php]{vb:math expression}[/php]12) متد stylevar : از این متد برای چاپ خروجی یک متغیر استایل استفاده میشود . که البته در اینده در رابطه با این نوع متد بیشتر توضیح خواهیم داد .
مثال و شیوه نامه کلی :
[php]{vb:stylevar name[.sub-part]}[/php]برچسب ها – تگ ها :
راهنمای متغیر های ویبولتین ( Stylevars ) – برچسب ها – Tags : نوعی دیگر از متد های ویبولتین به صورت تگ استفاده میشوند به صورت زیر :
13) برچسب literal : هر کد در داخل برچسب vb:literal به عنوان کد HTML ساده شناسایی می شود.
به عنوان مثال :
[php] <vb:literal>misc-code</vb:literal>[/php]
14) برچسب if : این برچسب نوع پیشرفته متد if هست ، در متد if شما محدودیت هایی دارد اما در برچسب if این محدودیت ها را ندارید و همچنین امکانات بیشتری را نیز دارید و در واقع کار های بیشتری با برچسب if می توان انجام داد :
مثال :
[php] <vb:if condition="condition">true result</vb:if>[/php]
یکی از امکانات این برچسب این هست که علاوه بر if میتوان از else نیزاستفاده کرد ، یعنی در صورتی که شرط صحیح باشد محتویات داخل برچسب چاپ میشود اما در صورتی که صحیح نباشد محتویات داخل برچسب else چاپ می شود :
مثال :
[php] <vb:if condition="condition">true result
</vb:if>
<vb:else />
flase result
[/php]
15) برچسب comment : از این برچسب میتوان برای چاپ توضیحات استفاده کرد ، این برچسب کار همان کامنت اچ تی ام ال را انجام میدهد
مثال :
[php] <vb:comment>a comment</vb:comment>output :
<!– a comment –>
[/php]
16) برچسب each در ویبولتین : این برچسب به نوعی همانند حلقه foreach عمل می کند ، در مثال و خروجی ان با این برچسب بیشتر آشنا خواهید شد ، پس در ادامه با ما همراه باشید :
[php] <!– our template code… –><vb:each from="users" key="userid" value="userinfo">
<li><a href="member.php?u={vb:var userid}">{vb:var userinfo.username}</a></li>
</vb:each>
[/php]
خروجی کد :
[php] <!– will output… –><li><a href="member.php?u=1">Adam</a></li>
<li><a href="member.php?u=2">Ben</a></li>
<li><a href="member.php?u=3">Chris</a></li>
[/php]راهنمای متغیر های ویبولتین ( Stylevars ) :
در زیر میتوانید مهم ترین متغیر های ویبولتین را مشاهده بفرمایید : (جهت مشاهده تصویر در سایز اصلی کلیک کنید .)
منابع استفاده شده : styleref_templates_syntax – متغیر ها در ویبولتین – استایل وار چیست ؟
امیدواریم از اموزش امروز (راهنمای متغیر های ویبولتین ( Stylevars )) لذت کافی را برده باشید ، سعی میکنیم در قسمت های بعدی راهنمای متغیر های ویبولتین ( Stylevars ) بیشتر در رابطه با متعیر های ویبولتین توضیحاتی را ارائه نماییم …
سلام
ممنون از توضیحات تون ، مثل همیشه عالی بود .
سلام ، خوشحالیم که برای شما مفید واقع شده است .
این متغییر ها چه بدردی میخوره ؟
ایا اصلا در ویبولتین کاربردی هم دارد ؟
باسلام و درود خدمت شما کاربر گرامی :
این متغییر ها در حوزه طراحی / برنامه نویسی و کدنویسی ویبولتین کاربرد دارد ، اگر شما یک متخصص ویبولتین (یک طراح قالب) یا فردی هستید که علاقه مند به یادگیری مباحث طراحی و برنامه نویسی ویبولتین هستید ، این اموزش میتواند برای شما مفید باشد.
در واقع میتونیم بگیم این آموزش برای افرادی که به صورت حرفه ای در حوزه ویبولتین فعالیت دارند ، میتوانید بسیار مفید باشد .
در خصوص سئوال دومتون هم ، بله کاربرد دارد ، در حال حاظر اکثر بخش های قالب ها و استایل های ویبولتین برمبنای همین کدها پیاده سازی شده است .
امیدوارم توضیحات ارائه شده برای شما مفید واقع شود .
سلام
مقاله ، کامل و جامعی بود ، خسته نباشید .