# پوسته اسکایلر (Skyler)

یک پوسته مدرن، زیبا و بهینه برای تایپچو

نسخه ۱.۳
پوسته اسکایلر - طراحی ریسپانسیو و مینیمال

## امکانات و ویژگی‌ها

- طراحی کاملاً ریسپانسیو
- منوی اصلی پویا با قابلیت انتخاب دسته/صفحه
- ویجت‌های سایدبار قابل تنظیم
- فیلدهای سفارشی: بنر، دانلود، پیش‌نمایش، گالری
- گالری تصاویر با لایت‌باکس و استایل‌های متنوع
- دکمه کپی خودکار کد
- دکمه بازگشت به بالا
- باکس نویسنده با آواتار و شبکه‌های اجتماعی
- سیستم کامنت‌دهی پیشرفته (پاسخ تا سطح ۲)
- صفحه خطای ۴۰۴ اختصاصی
- صفحه «لینک‌تری» (Linktree) مستقل
- صفحه «درباره من» اختصاصی
- بهینه‌سازی سئو
- پشتیبانی از تاریخ شمسی (jDate)
- نمایش تعداد بازدید (ViewsCounter)
- فونت وزیرمتن و فونت‌آسام به صورت آفلاین

چرا اسکایلر؟ سرعت بالا، انعطاف‌پذیری، ظاهر مدرن و پشتیبانی از افزونه‌های محبوب تایپچو.

## نصب و راه‌اندازی

1. دانلود پوسته: فایل‌ها را در مسیر `/usr/themes/skyler/` آپلود کنید.
2. فعال‌سازی: پیشخوان تایپچو → ظاهر → مدیریت پوسته‌ها → اسکایلر را فعال کنید.
3. تنظیمات اولیه: ظاهر → تنظیمات پوسته ← گزینه‌های مورد نیاز را پیکربندی کنید.
4. فایل‌های مورد نیاز: فونت وزیرمتن و Font Awesome به صورت آفلاین در پوسته قرار دارد. در صورت جابجایی، مسیرها را در `header.php` اصلاح کنید.

## تنظیمات پوسته در پیشخوان

پس از فعال‌سازی، گزینه «تنظیمات پوسته» در منوی ظاهر اضافه می‌شود.

### ۱. تنظیمات عمومی

فیلد | توضیح
--- | ---
آدرس لوگو سایت | لینک کامل تصویر لوگو. در صورت خالی، `img/logo.png` نمایش داده می‌شود.
آدرس فاویکون | لینک فایل favicon. پیش‌فرض: `img/favicon.ico`
لینک‌های سفارشی منو | هر خط: `عنوان|آدرس`
آدرس آواتار نویسنده | لینک تصویر پروفایل. در صورت خالی، گراواتار ایمیل مدیر یا `img/avatar.png`
درباره نویسنده | بیوگرافی کوتاه (نمایش در سایدبار و باکس نویسنده)

### ۲. تنظیمات شبکه‌های اجتماعی

لینک پروفایل‌های خود را در فیلدهای مربوطه وارد کنید. این لینک‌ها در صفحه «درباره من»، «لینک‌تری»، باکس نویسنده و فوتر استفاده می‌شوند.

### ۳. تنظیمات ویجت‌های سایدبار

گزینه | توضیح
--- | ---
نمایش جستجو | ویجت جستجو
نمایش درباره نویسنده | ویجت پروفایل نویسنده
نمایش عنوان «درباره نویسنده» | عنوان بالای ویجت
نمایش پست‌های اخیر | آخرین مطالب
نمایش نظرات اخیر | آخرین دیدگاه‌ها
نمایش دسته‌بندی | لیست دسته‌ها به همراه تعداد
نمایش برچسب‌ها | ابر برچسب‌ها

سبک ویژه درباره نویسنده: با فعال‌سازی این گزینه، ویجت «درباره نویسنده» با رنگ اصلی پوسته (primary) استایل‌دهی می‌شود.

### ۴. تنظیمات منوی بالا

- دسته‌بندی‌های منوی بالا: دسته‌بندی‌هایی که کنار «خانه» نمایش داده شوند.
- صفحات منوی بالا: صفحات مستقل برای نمایش در منو.

### ۵. تنظیمات فوتر

صفحات فوتر: صفحاتی که به صورت لینک در فوتر ظاهر می‌شوند.

## فیلدهای سفارشی نوشته‌ها

در ویرایشگر نوشته، بخش «فیلدهای سفارشی نوشته» در انتهای صفحه اضافه می‌شود.

فیلد | نوع | کاربرد
--- | --- | ---
آدرس تصویر شاخص (بنر) | متن | تصویر بزرگ بالای پست. اولویت با این فیلد است.
لینک دانلود فایل | متن | دکمه «دانلود فایل» در انتهای پست
لینک پیش‌نمایش | متن | دکمه «پیش‌نمایش»
لینک‌های گالری تصاویر | متن بلند | هر آدرس تصویر در یک خط → گالری لایت‌باکس
استایل نمایش گالری | انتخابگر | `style-zoom` (انیمیشن زوم) یا `style-dark` (روکش تیره)
تعداد ستون‌ها | انتخابگر | ۲، ۳ یا ۴ ستونه
شکل تصاویر | انتخابگر | افقی، عمودی، مربع

#### نمونه ورودی برای گالری:

    https://example.com/image1.jpg
    https://example.com/image2.jpg
    https://example.com/image3.jpg

## شخصی‌سازی دستی (هاردکدینگ)

این بخش نیاز به ویرایش مستقیم فایل‌های قالب دارد. پیش از هر تغییری، از فایل‌ها پشتیبان بگیرید.

فایل | موقعیت (خط تقریبی) | توضیح
--- | --- | ---
`about.php` | ۲۱ | `<h1>نام و نام خانوادگی</h1>` → نام خود را وارد کنید.
`links.php` | ۱۰۶, ۱۰۷ | عنوان و توضیحات صفحه لینک‌تری
`header.php` | ۲۳۴ و ۲۹۰ | دکمه CTA (دنبال کردن) – لینک و متن را تغییر دهید.
`header.php` | ۳۵۴ | زیرعنوان صفحه اصلی
`footer.php` | ۱۰۲ | متن کپی‌رایت
`index.php` (و header) | ۳۳۸ | عنوان H1 در هدر صفحه اصلی

همچنین می‌توانید لینک نمونه در `links.php` (خط ۱۱۳) را حذف یا ویرایش کنید.

## راهنمای استفاده از بخش‌های مختلف

### گالری تصاویر

- فیلد «لینک‌های گالری» را پر کنید (هر آدرس در یک خط).
- استایل، ستون و نسبت تصویر را انتخاب کنید.
- در صفحه پست، گالری با لایت‌باکس نمایش می‌یابد. (فلش‌های چپ/راست و Esc)

### دکمه کپی کد

به تمام بلوک‌های `<pre><code>` یک دکمه «کپی کد» اضافه می‌شود. پس از کلیک، متن کپی شده و دکمه سبز می‌شود.

### دکمه بازگشت به بالا

با اسکرول بیش از ۳۰۰ پیکسل ظاهر می‌شود. کلیک = اسکرول نرم به بالا.

### سیستم نظرات

- پاسخ: زیر هر نظر (تا سطح ۲) دکمه «پاسخ». با کلیک، فرم به پایین اسکرول شده و parent مقداردهی می‌شود.
- لغو پاسخ: از طریق لینک «(لغو)» در بالای فرم.
- آواتار مدیر: اولویت با `authorAvatar`، سپس `img/avatar.png` و نهایتاً گراواتار ایمیل مدیر.

### جستجوی موبایل

در نمای موبایل، آیکون جستجو کنار منوی همبرگری ظاهر می‌شود. با کلیک پنل جستجو از بالا پایین می‌آید.

## ساختار قالب و فایل‌ها

    skyler/
    ├── 404.php               # صفحه خطای ۴۰۴
    ├── about.php             # قالب صفحه «درباره من» (custom)
    ├── comments.php          # سیستم کامنت‌دهی بازگشتی
    ├── footer.php            # فوتر
    ├── functions.php         # توابع و تنظیمات پوسته
    ├── header.php            # هدر و منو
    ├── index.php             # صفحه اصلی (حلقه پست‌ها)
    ├── links.php             # صفحه «لینک‌تری» (custom)
    ├── page.php              # قالب پیش‌فرض صفحات
    ├── post.php              # قالب پیش‌فرض نوشته‌ها
    ├── sidebar.php           # نوار کناری
    │
    ├── css/
    │   ├── style.css         # استایل اصلی
    │   ├── fonts.css         # فونت وزیرمتن
    │   └── all.css           # فونت‌آسام ۶
    │
    ├── js/
    │   ├── comments.js       # منطق پاسخ به کامنت
    │   ├── copy-code.js      # دکمه کپی کد
    │   ├── go-to-top.js         # دکمه بازگشت به بالا
    │   └── gallery.js        # لایت‌باکس گالری
    │
    ├── img/                  # تصاویر پیش‌فرض
    └── webfonts/             # فایل‌های فونت آسام

## عیب‌یابی و نکات

مشکل | راه‌حل
--- | ---
فونت/آیکون نمایش داده نمی‌شود | وجود فایل‌های `fonts.css` و `all.css` و پوشه `webfonts` را بررسی کنید.
تاریخ میلادی است | پلاگین jDate را نصب و فعال کنید.
تعداد بازدید نمی‌آید | پلاگین ViewsCounter باید فعال باشد.
تصویر شاخص نمایش داده نمی‌شود | اولویت: فیلد banner → اولین تصویر محتوا → تصویر پیش‌فرض (`img/default-image.jpg`) → تصویر تصادفی از picsum.
منو دسته‌بندی/صفحه را نشان نمی‌دهد | در تنظیمات پوسته، گزینه‌های مربوطه را تیک بزنید.
پاسخ به کامنت کار نمی‌کند | فایل `comments.js` بارگذاری شده است؟ متغیر `respondId` در footer تولید می‌شود؟

نکته: اگر از تصویر پیش‌فرض استفاده می‌کنید، حتماً فایل `default-image.jpg` را در پوشه `img` قرار دهید.

## اعتبار و مجوز

طراح و توسعه‌دهنده: پوردریایی (Pourdaryaei)

نسخه: ۱.۳

وبسایت: http://typecho.ir

مجوز: GPLv2 یا بالاتر – آزاد برای استفاده شخصی و تجاری.

اگر پوسته را دوست داشتید، با گزارش باگ‌ها یا پیشنهادات ما را در بهبود آن یاری کنید.