سلام.. روزهای اول هر شخصی که به سمت این سیستم گروئیده میشه بزرگترین دقدقش نصب مد هست که صد البته با تاپیکهایی مواجه میشه که اصلا ازشون سر در نمیاره. مخصوصا وقتی هم رجوع میکنه و با فایلهایی مثل file.tpl مواجه میشه و خودش نمیدونه این فایلها مربوط به phpbb2 هستن. امروز تصمیم گرفتم یکم وقت بزارم و این اموزش رو تهیه کنم تا کاربران راحت تر بتونن این مدهارو نصب کنند. پیشنهاد میشه برای کامل تر کردن اطلاعات خود در مورد نصب مود به برچسبهایی که در انتهای تاپیک قرار دادم مراجعه کنید. که مطمئنا جمیع این آموزشها برای شما مفید واقع خواهد شد.

نصب مد به صورت ابتدایی...
سعی میکنم کاملا نصب مد و فایل instal.xml رو براتون باز کنم


تجربه: قبل از هر کاری که فک میکنید ممکنه درد سر ساز باشه مثل نصب همین مدها حتما از سایتتون پشتیبان بگیرید.

1. پیشنهاد نصب یکی از چند برنامه زیر بر روی کامپیوترتون
الف (یکی از برنامه های زیر برای ویرایش):
کد:
Macromedia Dream waver
Notepad++
Rapidphp


و یا حد اقل برنامه ای که باهاش بشه فایلهای css, php ,html رو ویرایش کرد. اینا پیشنهادهای من بودن.

ب (یکی از برنامه های زیر برای زیپ و آنزیپ):
کد:
winrar
winzip



پ (یکی از برنامه های زیر برای تست کردن مد روی لوکال هاست):
کد:
wamp
easyphp



ت (برنامه ای برای آپلود و دانلود سریع و مدیریت فضای هاست - اف تی پی):
کد:
Cutftp
ftpmanager



اینا برنامه هاییند که بهتره روی کامپیوتر نصب کنید.
2. دانلود مد

3.بعد از دانلود مد,( 95 درصد مواقع مدها داخل یه فایل zip یا rar هستن.گاهی هم به صورت htm,html و یا txt تو نت موجودن). داخل مدها دنبال فایلیبا نام install.xml بگردید.
توجه داشته باشید که همیشه install.xml نیست ------------- به مثالهای زیر توجه کنید.
کد:
mod name.xml
mod name.txt
mod name.html
install.xml
install.txt
install.html



4.در phpbb3 دو تا قالب وجود داره به صورت پیش فرض - prosilver و subsilver2. تمام قالبهای دیگه ای هم که دانلود میکنید یا برپایه prosilver هستند ویا subsilver2 پس باید ملزومات نصب مد در هر دو قالب رو به صورت کامل درمورد هر مود ادغام کنید.

5. به یاد داشته باشید در phpbb3 نصب مد به معنای ویرایش فایلهای موجود در پکیج phpbb3 که دانلود کردید هست.

6. من نصب یکی از مدها رو بهتون توضیح میدم تا راحت تر با این مساله آشنا بشید (Thank Post Mod Version 0.2.0)

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

حالا یه سری طراز بندی بکنم فایل install.xml رو...

دانستن این گزینه ها زیاد مهم نیست!
الف:About this MOD : اطلاعات در مورد مد رو میده.. مثلا زمانی که باید براینصب مد در اختیار فایل install بگذارید و ورژن و طراز مد.
ب: Authors : اطلاعات در مورد سازنده مد.

دانستن این گزینه ها تا درصد خاصی مهم است (به دلیل اینکه تو نصب تکرار میشه همین مطالب).
الف:Files to Edit : فایلهایی که باید ویرایش کنید در طول نصب. به طور مثالبرای نصب مد تشکر نسخه 0.2.0 باید این فایلها را ویرایش کنید. اگه دقتکنید در بین فایلهای زیر فقط ویرایش های قالب prosilver رو توضیح داده.در صورتی که از قالب subsilver2 استفاده میکنید. داخل پوشه دانلود مددنبال فایلی تحت عنوان subsilver2.xml باشید - این فایل ممکن هست داخلپوشه هایی به نام contrib یا template و از این قبیل باشیبعد از پیداکردن فایل به روشهایی که توضیح دادم اون فایل رو هم نصب کنید.

کد:
* memberlist.php,
* viewtopic.php,
* adm/style/acp_main.html,
* adm/style/acp_forums.html,
* includes/constants.php,
* includes/acp/acp_main.php,
* includes/functions_admin.php,
* includes/acp/acp_styles.php,
* includes/acp/acp_forums.php,
* language/en/acp/forums.php,
* styles/prosilver/imageset/en/imageset.cfg,
* styles/prosilver/template/viewtopic_body.html,
* styles/prosilver/template/memberlist_view.html,
* styles/prosilver/theme/buttons.css,
* styles/prosilver/theme/colours.css



ب:Included Files : در بسیاری از مدها بعد از آنزیپ کردن مد روی کامپیوترتونداخل مد پوشه ای به اسم root ملاحظه میکنید و یه سری فایلها توش وجوددارند. که باید اون فایلها رو داخل root - همونجایی که سایتتون رو نصبکردید آپلود کنید. مثلا اگه phpbb3 رو مستقیم توی public_html آپلود کردیدو سایتتون رو نصب کردید فایلهای داخل root رو هنگام نصب مد باید توی همینآدرس آپلود کنید.
البته فایلهای دیگه ای هم هستن که باید آپلود بشه برای این مد - من فقط این کلید رو مثال زدم.

دانستن این بخش ها هم زیاد مهم نیست

الف: Additional MODX Files : اطلاعاتی در مورد زبان و نسخه های به روز رسانی و از این قبیل.
ب:Disclaimer & Other Notes : بهتون میگه واسه امنیت مد رو از phpbbدانلود کنید و مد رو برای ورژن phpbb که ساخته شده معرفی میکنه و یه سریاطلاعات دیگه!
پ: License & English Support : گواهی و مدرک ثبت شده این مد در مجمع سیستمهای منبع باز.
ت: MOD History : چند نمونه از این مد اومده و آپدیت هاش... به نوعی تاریخچه مد رو میگه.

خب حالا به مهم ترین بخش رسیدیم که باید با دقت تمام انجام بشن

باز هم تاکید میکنم از فایلهای phpbb و database یا همون پایگاه دادتون حتما پشتیبان بگیرید!


1.SQL : کدهایی که در این بخش وارد شده باید در پایگاه داده درج بشه بدینمنظور دستورات زیر رو پیگیری کنید. (همه مدها این بخش رو ندارند)

الف: به پنل هاستتون برید و با وارد کردن username و password وارد هاستتون بشید.
ب:به دنبال گزینه phpMyAdmin بگردید و روش کلیک کنید. (در پنلهایی مثلdirect admin بعد از کلیک کردن ازتون پسورد میخواد شما رمز و پسوردهاستتون رو بدید) تا وارد این پنجره بشید.
پ: در ستون سمت چپ که پسزمینه تقریبا آبی رنگ داره و بالای ستون لوگو phpmyadmin هست باید دیتابیس انجمن تون رو انتخاب و روش کلیک کنید.
ت: بعد از مشاهده کردن جداولزیر لوگو phpmyadmin تو همون ستون چهار یا پنج تا آیکون کوچیک هست اگه ماوستون رو روی آیکن ها ببرید اسمشون رو میبینید.. روی یکی از آیکن ها خیلیریز نوشته شده SQL و اگه موس رو روش ببرید query window رو میبینید. روشکلیک کنید.
ث: دستوراتی که در قسمت SQL فایل install.xml موجود بود رودر همین پنجره(SQL) - ه paste کنید. (اگه در بخش sql پنجره ای که با کلیکروی quarey window باز شده دستور دیگه ای نوشته اون دستور رو پاک کنید بعداینو paste کنید.)


2. Edits : بخشی که وقتتون رو حسابی واسه نصب مد میگیره ولی همیشه اینطوری نیست. گاهی اوقات فقط یکم وقت میزارید واسش.

الف: Open:memberlist.php : بدین معنی که این فایل رو باز کنید (با یکی ازویرایشگرهای php که معرفی کردم) (به دستور Open دقت کنید!). گاهی ممکنهآدرس به این صورت باشه.
کد:
Open: adm/style/acp_main.html



یعنیاول سراغ root برید (root = public_html) (root=jaei ke siteton nasbkardid) بعد پوشه adm و بعد style و سر انجام فایل acp_main.php رو بازکنید. (توسط ویرایشگر php که در اول معرفی کردم).

بند اول:Find : با مثال توضیح میدم...
حالابه فرض ما فایل memberlist.php رو باز کردیم. بعد از اون با دستورFind رو برو میشیم .. بعد از این دستور (Find) یه سری کد زیرش میده تو یهکادر سفید.. به طور مثال این کد
کد:
// Start session management
$user->session_begin();
$auth->acl($user->data);



کار شما اینه که به دنبال این کد توی فایل memberlist.php بگردید!

بند دوم: دستور add after و بعدش یه کد دیگه که تو یه کادر سفید زیرش داده میشه مثل :
کد:
//Begin Thank Post MOD
$user->add_lang('mods/thanks');
//End Thank Post MOD



گزینه اول و بند اول و بند دوم اینو میگه که شما اول فایل memberlist رو بازکنید سپس در بند اول کدی که معرفی کرده رو توی اون فایل پیدا کنید و دربند سوم میگه بعد از کدی که پیدا کردید کد بند دوم رو بعدش قرار بدید(دقیقا بعد از کد بند اول با یک بار enter زدن ).
که در نهایت به این شکل در میاد
کد:
// Start session management
$user->session_begin();
$auth->acl($user->data);
//Begin Thank Post MOD
$user->add_lang('mods/thanks');
//End Thank Post MOD



حالا یه موقه هایی جای add after add before میاد.. فک کنم حدس زدید جریان چطور پیش میره!

بند سوم: add before : بزارید یه فایل دیگه رو مثال بزنم:

*. فایل Open: viewtopic.php - یعنی فایل Viewtopic.php رو باز کنید
*.گزینه Find - یعنی کدی که زیر find تو کادر سفید هست رو پیداکنید. (توجه داشته باشید همیشه این کد نیست و برای نصب هر مد کدهای متفاوتی رو باید پیدا و ویرایش کنید)
حالا ما تو فایل viewtopic.php این کد رو پیدا میکنیم.
کد:
// Send vars to template



بعد مثلا با دستور add before مواجه میشیم که کد زیر رو تو کادر سفید زیرش داره!

کد:
//Begin Thank Post MOD
$user->add_lang('mods/thanks');
//End Thank Post MOD



بدین معنی که این کد رو قبل از کدی که گزینه add before توی کادر سفید زیرش داره قرار بدید. که در نهایت داریم:

کد:
//Begin Thank Post MOD
$user->add_lang('mods/thanks');
//End Thank Post MOD
// Send vars to template



********************
حالا گاهی اوقات به یه سری کد مثل این بر میخوریم...

open : باز کنید
کد:
includes/functions_admin.php



find : پیدا کنید
کد:
$table_ary = array(POSTS_TABLE, REPORTS_TABLE);


In-line Find - خب این دستور تازه به چشمتون خورد ولی منظورش اینه که خط کدی که معرفی کرده رو توی خط کد بالا پیدا کنید.
کد:
REPORTS_TABLE


In-lineAdd after - این دستور هم تازست.. منظورش اینه که خط کد زیر رو بعد از خطکدی که پیدا کردید اضافه کنید (البته گاهی جای In-line Add after باIn-line Add before مواجه میشید که باید خط کد رو قبل اضافه کنید ولی الانمنظور سازنده مد In-line Add after هست و باید کد رو بعد اضافه کنید).

کد:
, THANKS_TABLE


قسمت : DIY Instructions
گاهی ممکنه با یه دستوری مشابه این مواجه بشید
کد:
Copy: root/db_update.php
To: phpbb root and run this with your browser or they use the sql command from the manual.
After using this file, please delete it to avoid errors.
After installing this mod you must refresh your template, theme, and imageset and clear your cache..



خب.. منظورش چیه!؟
خط اول و دوم میگه فایل db_update.php رو که داخل مد موجود هست توی root آپلود کنید سپس اجراش کنید توی مرور گر



بعداین فایل رو نصب کنید.. (اگه اجراش کنید خودش نصب میشه) - (این دستور شامل همه مدها نمیشه تا کنون من فقط تو مد تشکر باهاش روبرو شدم پس زیاد سخت نگیرید.)
خط سوم میگه بعد از نصب این دستور فایل db_update.php رو از داخل root حذف کنید.

این سه تا خط کم پیش میاد واسه نصب مدها...

خط چهارم که شامل اکثر مدها میشه شایدم همه مدها.. بعد از نصب مد به آدرس زیر تو سایتتون برید

کد:
ACP > general > clear cache



معادل فارسی

مرکز مدیریت > اصلی > پاک کردن نهانگاه

و بقیه موارد که گاها ازتون میخواد - این موارد زیر شرط دارن:

در صورتی که در فایلهای قالبتون تغییر ایجاد کرده باشید هنگام نصب مد
مرکز مدیریت > استایل > قالبها > روبروی قالب مورد نظرتون > بروز رساتی

در صورتی که در قالب سایتتون عکسی آپلود کرده باشید هنگام نصب مد
مرکز مدیریت > استایل > مجموع عکسها > روبروی قالب مورد نظرتون > بروز رساتی

هیچ وقت فایلهاتون رو داخل هاست ویرایش نکنید.
سعی کنید اول روی localhost مدتون رو تست کنید.و آخر همه گزینه ها : Save all files. End of MOD.
Youhave finished the installation for this MOD. Upload all changed filesto your website. If the installation went bad, simply restore yourbacked up files.
نصب مد شما به اتمام رسید. تمام فایلهای ویرایش شده را داخل سایتتان آپلود کنید. در صورتی که نصب مد نا موفق بود فایلهای پشتیبان را آپلود کنید.