) | %all_items تعداد کل نتایج
%id شناسه | %url و %href نشانی مطلب (/post_url/) | %link کد آماده با عنوان
%title عنوان | %excerpt چکیده (خط جدید →
) | %content متن کامل مطلب %src نشانی تصویر شاخص یا خالی | %img تگ![]()
یا خالی
%thumb تگ ![]()
بندانگشتی با src="/...-thumb.jpg"
(بندانگشتی حداکثر 100×100؛ توصیه: فهرست‌های عمومی %img، ابزارک کم‌حجم %thumb
با پس‌زمینه placeholder در CSS)
%date میلادی Y-m-d | %time H:i:s | %pdate شمسی Y/m/d | %htime زمان نسبی («۲ ساعت پیش»)
(قالب‌ها ثابت‌اند؛ قالب دلخواه با JS و تبدیل %date — تابع pdate در پیوست الف)
%category_links پیوندهای دسته‌ها | %category_names عناوین جداشده با tab
%tag_links و %tag_names مانند بالا برای برچسب‌ها
(دسته/برچسب بدون نشانی — ذخیره‌شده با # — در خروجی نمی‌آیند)
%comments_no شمار دیدگاه‌های سطح اول منتشرشده | %comments_all_no شمار همه دیدگاه‌های منتشرشده
%visit بازدید یکتا | %votes رشته آرا مثل "1,0,0,2,1,0" یا خالی
%author_name نام | %author_url نشانی معرفی | %author_link کد نویسنده
%buy کد دکمه خرید (فقط فروشگاه فعال و قیمت>0) | %price قیمت با جداکننده هزارگان
| %has_price yes/no
%type %category %tags %template %commenting %created %modified فیلدهای خام posts
متغیرهای theme_vars مطلب هم با %نام فراخوانی می‌شوند.
صفحه‌بندی: %paging() در category/tag/search با i خالی؛ اگر حلقه i عددی دارد:
%paging(4) و %link(4) (پیوند کلیک‌پذیر صفحه دسته/برچسب).
خروجی %paging فقط - هاست (اعداد، قبلی/بعدی، سه‌نقطه، کلاس active) —
خودت با
(نوسازی با ?r=عدد تصادفی).
ایمیل گیرنده از متغیر پوسته (رایج: contact_email از نوع _email).
پاسخ: OK. یا ERROR|پیام. نمونه کامل در پیوست پ.
- هر خطای POST با پیشوند ERROR|پیام فارسی آماده برمی‌گردد.
# دیدگاه‌ها و آرا (فقط در post.html، فقط برای مطالب)
حالت post_commenting مطلب: C=غیرفعال | O=عمومی فوری | M=فقط اعضا فوری |
خالی=عمومی با تأیید مدیر (دیدگاه اعضا همیشه فوری منتشر می‌شود)
وقتی دیدگاه مجاز نیست، %comment_display_class مقدار no-display می‌دهد تا بخش
بازخورد و دیدگاه با CSS پنهان شود؛ ارسال ناخواسته هم خطای مناسب از سرور می‌گیرد.
API (POST به /):
1) readcomments=&last_cid=<آخرین id بارگیری‌شده>&parent=<0 یا id والد>
→ OK\n و هر دیدگاه یک سطر با ۷ فیلد جداشده با Tab:
id، name، text، date (میلادی Y-m-d H:i:s)، plus، minus، children (تعداد پاسخ‌ها)
حداکثر ۵۰ مورد در هر بار؛ ادامه فهرست با last_cid.
2) رأی دیدگاه: comment_id=&vote=<1|-1> (+captcha) → OK\n,,
3) رأی مطلب: post_id=&vote=<0..5> (+captcha) → OK\n,...,,
4) ثبت دیدگاه: post_id + comment-name + comment-text + parent (+captcha) →
OK|دیدگاه شما منتشر شد. یا OK|دیدگاه شما دریافت شد و پس از بازبینی مدیر سایت، منتشر خواهد شد.
کپچا: تصویر /captcha/ چهاررقمی در مودال؛ هر پاسخ درست ۲۰ عملیات (رأی/دیدگاه) را
پوشش می‌دهد (%captchano مقدار اولیه را می‌دهد)؛ ثبت هر دیدگاه شمارنده را صفر
می‌کند؛ پاسخ غلط → نمایش مجدد مودال (تابع go_captcha در پیوست الف).
قواعد سرور: نام تک‌سطر بدون < > " ' / | % @ (پیشنهاد maxlength="30")؛ متن بدون
تگ حداکثر ۲۰۴۸ نویسه (پیشنهاد maxlength="2048")؛ عضو با نام ثبت‌شده خودش دیدگاه
می‌دهد؛ مهمان نمی‌تواند از نام اعضای سایت استفاده کند.
اسکلت HTML الزامی (درون حلقه ITEMS در post.html):
عناصر #comments-container و .comment-section-title الزامی‌اند.
کد پیوست الف را عیناً در script.js قرار بده و فقط HTML و CSS تولید کن.
کلاس‌های CSS مورد نیاز:
.vote_btns و iهای .vote-plus/.vote-minus/.vote-haha/.vote-wow/.vote-sad/.vote-angry با .active
.comment .comment-inf .comment-name .comment-date .comment-votes .comment-plus .comment-minus
.comment-text .comment-buttons .comment-load-replies .comment-reply-toggle .readcomments-more
.comments-loading .comment-form .comment-form-info (حالت‌های success/error/wait) #captcha_modal
برچسب‌های شش‌گانه رأی در JS مرجع: موافق، مخالف، خنده‌دار، تعجب‌آور، غمگین، ظالمانه (قابل تغییر).
تاریخ شمسی دیدگاه با pdate(p[3])+p[3].substring(10) — تابع pdate سراسری است.
# فروشگاه (اختیاری)
- با فعال بودن فروشگاه، موتور پیش از تگ تزریق می‌کند:
پوسته این تگ را نمی‌سازد و بازنویسی نمی‌کند. STORE_CURRENCY واحد پول است؛
آن را در کد هاردکد نکن. واحد خالی کالا یعنی شمارش‌ناپذیر (تعداد قفل روی ۱).
receipts شماره رسیدهای نشست جاری است (برای «رسیدهای اخیر»).
- دکمه خرید مطلب با %buy ساخته می‌شود؛ کلاس‌ها: site-store ، site-store-price ،
site-store-btn (دکمه بدون متن؛ برچسب/آیکون با CSS، مثل
.site-store-btn:before{content:'افزودن به سبد'}) و site-store-{route}.
- سبد در localStorage با کلید cart_str، قالب: pid,تعداد;pid,تعداد;
- تکمیل سفارش: فرم POST به /checkout/ با cart ، customer[name] ، customer[email] ،
customer[phone] ، customer[comment] ، pay_method (شماره روش از STORE.payment_methods).
ادامه مسیر (درگاه پرداخت یا واریز) سمت موتور است.
- صفحه رسید مشتری /receipt/شماره/ از سمت موتور رندر می‌شود و بخشی از پوسته نیست.
- محدودیت سرور: حداکثر ۳ سفارش پرداخت‌نشده در روز برای هر IP.
- کد پیوست ب به‌عنوان مرجع؛ می‌توانی عیناً استفاده کنی یا با همان قراردادها بازنویسی کنی.
- کلاس‌های CSS فروشگاه (برای استفاده از کد مرجع): #store_cart_button
#store_cart_modal .store_cart_modal_inner .store_cart_modal_header .close_cart_btn
.store_cart_modal_table .store_cart_modal_row .store_cart_modal_footer
.store_cart_modal_buttons .store_cart_modal_over .store_cart_modal_cond
.store-customer-form .store_cart_modal_payment_methods
.store_cart_modal_payment_method_desc .catalog_modal_form #filterinp
.catalog_data_table_head #catalog_data_table .catalog_table_row
#recent_receipts_button .close_receipts_btn
# قواعد تحویل خروجی
- هر فایل کامل و جداگانه، با مسیر دقیق (مثل themes/theme_name/pages/index.html)
- در پایان، چک‌لیست فایل‌ها و کلاس‌های الزامی رعایت‌شده را اعلام کن.
# پیوست الف — کد مرجع دیدگاه‌ها و آرا
این کد را عیناً در script.js قرار بده. تابع pdate در ابتدای آن سراسری تعریف شده
و پیوست ب نیز به همین تابع وابسته است؛ پس هر دو پیوست باید در یک فایل js باشند.
// -------- { Shared helper — تابع سراسری تاریخ شمسی --------
function pdate(datestr){
var y=0;
var m=0;
var d=0;
if(!datestr){
var today = new Date();
y=today.getFullYear();
m=today.getMonth()+1;
d=today.getDate();
}else{
var p=datestr.replace(/-/g,' ').replace(/\//g,' ').split(' ');
y=parseInt(p[0],10);
m=parseInt(p[1],10);
d=parseInt(p[2],10);
}
var g_days_in_month=[31,28,31,30,31,30,31,31,30,31,30,31];
var m_days_in_month=[31,31,31,31,31,31,30,30,30,30,30,29];
var gy = y-1600;
var g_day_no = 365*gy+Math.floor((gy+3)/4)-Math.floor((gy+99)/100)+Math.floor((gy+399)/400);
for(var j=0; j2 && ((gy%4==0 && gy%100!=0) || (gy%400==0))){
g_day_no++;
}
var m_day_no = g_day_no + d - 80;
var j_np = Math.floor(m_day_no/12053);
m_day_no = m_day_no % 12053;
var py = 979 + 33*j_np + 4*Math.floor(m_day_no/1461);
m_day_no %= 1461;
if(m_day_no >= 366){
py += Math.floor((m_day_no-1)/365);
m_day_no = (m_day_no-1)%365;
}
for(var j=0; j<11 && m_day_no >= m_days_in_month[j];j++){
m_day_no -= m_days_in_month[j];
}
var pm=j+1;
var pd=m_day_no+1;
return py+'/'+(pm<10?'0':'')+pm+'/'+(pd<10?'0':'')+pd;
}
// -------- Shared helper } --------
// -------- { Comment and Vote Script --------
var captchano = 0;
if(document.querySelector('#comments-container') || document.querySelector('.votes_area')){
var e=document.getElementById('comments-container');
if(e){
readcomments(0);
captchano=parseInt(e.getAttribute('captchano'));
}
if(document.querySelector('.comment-form-name') && document.querySelector('.comment-form-name').value.length==0 && localStorage.getItem('comment-form-name')){
document.querySelector('.comment-form-name').value=localStorage.getItem('comment-form-name');
}
var vas=document.querySelectorAll('.votes_area');
if(vas){
for(var i=0;i';
for(var j=0;j'+v6[j]+'';
}
s+='
';
vas[i].innerHTML=s;
}
function vote(captcha){
var e=captcha?document.querySelector('.triggered'):event.target;
if(e.className.indexOf('active')!=-1){return;}
var et=document.querySelector('.triggered');
if(et){et.classList.remove('triggered');}
e.classList.add('triggered');
if(!captcha && captchano<=0){return go_captcha('vote');}
e.style.pointerEvents='none';
e.style.opacity=0.6;
var xhr = new XMLHttpRequest();
xhr.onload = function(){
e.style.pointerEvents='auto';
e.style.opacity=1;
if(xhr.responseText.indexOf('ERROR')===0){
go_captcha('vote');
}else if(xhr.responseText.indexOf('OK')===0){
var ac=e.parentNode.querySelector('.active');
if(ac){ac.classList.remove('active');}
e.classList.add('active');
var p=xhr.responseText.substring(3).split(',');
if(e.parentNode.id.indexOf('post')==0){
captchano=parseInt(p[6]);
var a=e.parentNode.querySelectorAll('i');
for(var j=0;j) | %content متن کامل مطلب %src نشانی تصویر شاخص یا خالی | %img تگ
- بپیچ. در index.html با i خالی خروجی ندارد.
کلیدواژه‌های ویژه صفحه جستجو: %search_finds (تعداد یافته‌ها) | %search_page
(شماره صفحه جاری) | %search_pages (تعداد صفحات)
# امکانات پیکربندی
- theme_vars: "theme_vars": "pretitle,پیش‌عنوان;pre_text,پیش‌متن;"
فیلد اختصاصی مطلب؛ قالب «نام,برچسب» و جداکننده ;؛ نوع از پسوند (پیش‌فرض input)؛
ردیف آن در فرم ویرایش مطلب ظاهر می‌شود؛ فراخوانی با %نام درون حلقه ITEMS.
- theme_tags_img=yes و theme_categories_img=yes: انتخاب تصویر شاخص برای
برچسب/دسته در مدیریت؛ نمایش تصویر دسته جاری در category.html:
بازخورد
دیدگاه‌ها
'+
'
'+
''+p[1]+'
'+
''+pdate(p[3])+p[3].substring(10)+'
'+
''+
''+(parseInt(p[4])?'+':' ')+p[4]+''+
''+(parseInt(p[5])?'-':' ')+p[5]+''+'
'+
''+p[2]+'
'+
''+
'';
}
}
e.insertAdjacentHTML('beforeend',h);
if(n){
e.querySelector('.comment-load-replies').style.display='none';
}else{
var b=document.querySelector('.readcomments-more');
if(b){b.parentNode.removeChild(b);}
var m=parseInt(document.getElementById('comments-container').getAttribute('comments_no'))-document.querySelectorAll('#comments-container > .comment').length;
if(m>0){
e.insertAdjacentHTML('beforeend','');
}
}
if(window.location.hash.indexOf('#comment-')==0){
setTimeout(function(){var c=document.querySelector(window.location.hash);if(c){c.scrollIntoView();}},500);
}
}
}
xhr.open('POST', '/');
xhr.setRequestHeader('Content-Type','application/x-www-form-urlencoded');
xhr.send('readcomments='+document.getElementById('comments-container').getAttribute('post_id')+'&last_cid='+last_cid+'&parent='+n);
}
function reply(n){
var e=document.getElementById('form_reply');
if(e){
e.parentNode.removeChild(e);
if(e.getAttribute('reply_to')==n){
return;
}
}
var h=''+document.querySelector('.comment-form').innerHTML+'
';
var name=document.querySelector('.comment-form input[name=comment-name]').value;
document.getElementById('comment-'+n).insertAdjacentHTML('beforeend',h);
document.querySelector('#form_reply input[name=comment-name]').value=name;
document.querySelector('#form_reply input[name=parent]').value=n;
document.querySelector('#form_reply textarea').focus();
}
function go_captcha(cb){
var h='×
لطفاً کد چهار رقمی زیر را وارد کنید.
'+xhr.response.substr(3)+'
';} }else if(xhr.responseText.indexOf('ERROR|')===0){ p.innerHTML=xhr.response.substr(6); p.className='comment-form-info error'; } }; xhr.onerror = function(){ f.style.pointerEvents='auto'; p.innerHTML='دیدگاه ارسال نشد.'; p.className='comment-form-info error'; } xhr.open('POST', '/'); xhr.send(formdata); } } // -------- Comment and Vote Script } -------- # پیوست ب — کد مرجع فروشگاه این کد با گارد if(typeof(STORE)=='object') در سایت غیرفروشگاهی بی‌اثر است. تابع pdate از پیوست الف استفاده می‌کند؛ واحد پول از STORE.STORE_CURRENCY خوانده می‌شود. // -------- { Store Script -------- if(typeof(STORE)=='object'){ if(localStorage.getItem('cart_str')){buy(-1);} if(typeof(STORE.receipts)=='object' && STORE.receipts.length>0 && localStorage.getItem('dismiss_recent_receipts')!='yes'){ var h=''; document.body.insertAdjacentHTML('beforeend',h); } function buy(pid){ var e=document.getElementById('store_cart_button'); if(!e){ document.body.insertAdjacentHTML('beforeend', ''+ ''); } if(pid!=-1){ document.getElementById('store_cart_button').style.display='none'; document.getElementById('store_cart_modal').style.display='block'; var cart_str=(localStorage.getItem('cart_str'))?(localStorage.getItem('cart_str')):''; var a=cart_str.split(';'); var pids=[]; var ords=[]; for(i=0;iشناسهشرحواحدفی
';
var ks=Object.keys(STORE.catalog);
if(ks.length==0){
h+=''+ks[i]+''+STORE.catalog[ks[i]][1]+''+STORE.catalog[ks[i]][3]+''+(STORE.catalog[ks[i]][2]+'').replace(/\d(?=(\d{3})+$)/g, '$&,') +'
';
}
h+='';
document.querySelector('.store_cart_modal_over').innerHTML=h;
justify_store_cart_modal();
}
function refilter() {
var q=document.getElementById('filterinp').value.toUpperCase();
document.getElementById('filterinp').parentNode.querySelector('span').style.display=(q.length==0)?'none':'block';
var a=document.querySelectorAll('.catalog_table_row');
for(var i=0;iموردی یافت نشد.
'; } for(var i=0;iروشی برای پرداخت تعیین نشده است.
'; }else{ h+=''; } document.querySelector('.store_cart_modal_over').innerHTML=h; justify_store_cart_modal(); } } // -------- Store Script } -------- # پیوست پ — نمونه فرم تماس (HTML + JS) نام فیلدها و اسکریپت ارسال معیار است؛ ساختار چیدمان (row و col-lg) در پوسته خودت آزاد است. تابع sendform با send_comment پیوست الف تداخل ندارد. # درخواست من یک پوسته «[نوع پوسته]» با نام «[نام دلخواه]» بساز. ویژگی‌های مورد نظر: [رنگ‌بندی، چیدمان، بخش‌ها، سبک و...]