آموزش نصب mod در phpbb

[Professional]

آموزش نصب mod در phpbb

Mod چیست؟
سیستم هایی که با اعمال تغییرات در فایل های انجمن به انجمن ما اضافه می شوند به اصطلاح mod نامیده می شوند. مثلا: نمایش کاربرانی که ظرف 24 ساعت گذشته از انجمن دیدن کرده اند – مرکز دانلود – امتیاز دهی به تاپیک ها و...


برای نصب یک mod باید برای شروع اول از دیتابیس پشتیبان بگیرید .
به نظر من این از نصب خود mod هم مهمتر هست چون اگر احیانا مشکلی پیش بیاد می توانید انجمن خود را به شکل اول برگردانید .
در کل نصب یک mod کار خیلی خطرناکی هست و باید به دقت انجام بشه و غیر از پشتیبان گرفتن شما باید mod مورد نظر خود را یک بار بر روی شبکه محلی (localhost) نصب کنید و در صورت موفقیت آمیز بودن نصب مد , اقدام به نصب mod بر روی انجمن اصلی خودتون بکنید.
از نصب مد به شکل مستقیم و در حالت online به شدت پرهیز کنید !
برای شروع کار mod مورد نظر را که دانلود کرده اید را باز کنید که احتمالا با فرمت txt یا mod خواهد بود و با یک نرم افزار ویرایش متن ساده مثل notepad و یا wordpad آن را باز کنید .
همچنین می تونید از Emeditor که قبلا اینجا معرفی کردم استفاده کنید:
معرفی EmEditor Professional 7.00 یک ویرایشگر حرفه ای

[Professional]

فرمان های مورد استفاده هنگام نصب مد:

فرمان " COPY "

اگر در mod یک فرمان شبیه به این دیدید :

#
#-----[ COPY ]------------------------------------------
#
copy file.php to file.php
copy file.tpl to templates/subSilver/file.tpl

این فرمان در این مثال به این معنی هست که شما باید فایل "file.php" را به پوشه اصلی phpbb کپی کنید و فایل "file.tpl" را باید به پوشه قالبها منتقل کنید بدون اینکه آنها رو تغییر دهید.
اگر مانند این مثال در زیر کلمه copy فقط نام فایل قرار داشت باید فایل را به پوشه اصلی منتقل کنید ولی اگر مسیری را مشخص کرده بود شما باید فایل را در آن مسیر کپی کنید.

[Professional]

فرمان " OPEN "

اگر در mod به این فرمان برخورد کردید :

# 
#-----[ OPEN ]------------------------------------------ 
# 
common.php

در اینجا کار سختی در پیش ندارید و فقط باید فایل مورد نظر را با یک نرم افزار ویرایش متن ساده مثل notepad و یا wordpad باز کنید البته من شدیدا توصیه میکنم برای نصب مد و ویرایش فایلها از نرم افزار dream weaver mx استفاده کنید.

همچنین دقت کنید که اگر در زیر فرمان open فقط نام فایل باشد یعنی اینکه آن فایل در پوشه اصلی قرار دارد و اگر مسیری را نوشته باشد , شما باید به آن مسیر را طی کنید و فایل مورد نظر را باز کنید.

[Professional]

فرمان " FIND "

بعد از فرمان open پر مصرفترین فرمان همین فرمان می باشد و در بیشتر اوقات بعد از فرمان open این فرمان را خواهید دید .

# 
#-----[ FIND ]------------------------------------------ 
# around line 184 
// 
// Show 'Board is disabled' message if needed. 
//

هنگامی که به این فرمان برخورد کردید باید دنبال آن بخش ار کد که در mod گفته شده بگردید و آن را پیدا کنید . در بعضی از mod ها حدود تقریبی قرار گیری آن بخش از کد در mod گفته می شود مثل همین مثال که گفته شده این بخش در حدود خط 184 قرار دارد و شما باید دنبال این بخش از کد در حدود خط 184 بگردید :

// 
// Show 'Board is disabled' message if needed. 
//

دقت کنید که خطوطی که با # شروع میشود مربوط به mod بوده و نباید آنها را به حساب بیاورید . درست مثل مثال بالا.

[Professional]

فرمان " BEFORE ADD "

اگر در mod مورد نظر به این فرمان برخورد کردید :

# 
#-----[ BEFORE, ADD ]-------------------------------------- 
# 
include($phpbb_root_path . 'attach_mod/attachment_mod.'.$phpEx);

در اینجا باید کد مورد نظر را که در mod ذکر شده دقیقا در یک خط قبل از بخش کدی که پیدا کرده بودیم , کپی کنیم
در مثال قبل ما یک بخش از کد را در یک فایل در حدود خط 184 پیدا کردیم و حالا این بخش از کد را درست یک خط قبل از آن اضافه میکنیم
و کد مورد نظر برای مثال ما می شود :

include($phpbb_root_path . 'attach_mod/attachment_mod.'.$phpEx);

// 
// Show 'Board is disabled' message if needed.
//

[Professional]

فرمان " AFTER ADD "

# 
#-----[ AFTER, ADD ]------------------------------------------ 
# 
include($phpbb_root_path . 'attach_mod/attachment_mod.'.$phpEx);

این فرمان درست شبیه به فرمان قبل می باشد ولی با این تفاوت که به جای اینکه کد مورد نظر را به خط قبلی اضافه کنیم , باید بخش کد را به خط بعدی کپی کنیم و برای مثال ما میشود به این شکل :

include($phpbb_root_path . 'language/lang_' . $board_config['default_lang'] . '/' . $lang_file . '.' . $phpEx); 
include($phpbb_root_path . 'attach_mod/attachment_mod.'.$phpEx);

[Professional]

فرمان " REPLACE WITH "

# 
#-----[ REPLACE WITH ]------------------------------------------ 
# 
<form action="{S_POST_ACTION}" method="post" name="post" onsubmit="return checkForm(this)" {S_FORM_ENCTYPE}>

این فرمان همیشه با فرمان find همراه می شود و هرگاه به این فرمان برخورد کردید باید آن بخش کدی را که در فرمان find پیدا کرده بودید را پاک کنید و با کدی که در این فرمان قرار دارد , جایگزین کنید . برای مثال :

# 
#-----[ FIND ]--------------------------------------------- 
# around line 225 
<form action="{S_POST_ACTION}" method="post" name="post" onsubmit="return checkForm(this)"> 

# 
#-----[ REPLACE WITH ]--------------------------------------- 
# 
<form action="{S_POST_ACTION}" method="post" name="post" onsubmit="return checkForm(this)" {S_FORM_ENCTYPE}>

در مثال بالا در فرمان find شما باید خط مورد نظر را پیدا کنید که و با تکه کدی که در فرمان replace with گفته شده است , جایگزین کنید . درست به این شکل


به عنوان مثال در بالا من این بخش از کد را که در فرمان find گفته شده بود پیدا کردم

<form action="{S_POST_ACTION}" method="post" name="post" onsubmit="return checkForm(this)" {S_FORM_ENCTYPE}>

form action="{S_POST_ACTION}" method="post" name="post" onsubmit="return checkForm(this)">

حالا در فرمان replace گفته شده که من این بخش از کد را جایگزین کد قبلی کنم . به خط بالا دقت کنید

<form action="{S_POST_ACTION}" method="post" name="post" onsubmit="return checkForm(this)" {S_FORM_ENCTYPE}>

حالا من کد قبلی را حذف کردم و کد جدید را جایگزین کد قبلی کردم درست مثل مثال بالا.

[Professional]

فرمان " IN-LINE FIND "

این فرمان درست بعد از فرمان find استفاده می شود :

# 
#-----[ IN LINE FIND ]------------------------------------------ 
# 
t.topic_title,

برای درک بهتر من یک مثال کاملتر میزنم

# 
#-----[ FIND ]------------------------------------------ 
# 
$select_sql = ( !$submit ) ? ", t.topic_title, p.enable_bbcode, p.enable_html, p.enable_smilies, p.enable_sig, p.post_username, pt.post_subject, pt.post_text, pt.bbcode_uid, u.username, u.user_id, u.user_sig" : ''; 
# 
#-----[ IN-LINE FIND ]------------------------------------------ 
# 
t.topic_title,

این فرمان به شما می گوید که باید دنبال یک تکه کد کوچکتر در خطی که با فرمان find پیدا کرده بودید , بگردید . برای مثال من این تکه کد را که فرمان find گفته شد را پیدا کردم . به مثال دقت کنید:

$select_sql = ( !$submit ) ? ", t.topic_title, p.enable_bbcode, p.enable_html, p.enable_smilies, p.enable_sig, p.post_username, pt.post_subject, pt.post_text, pt.bbcode_uid, u.username, u.user_id, u.user_sig" : '';

حالا که این بخش را پیدا کردم به فرمان inline find دقت میکنم به مثال دقت کنید .

t.topic_title,

حالا من باید این تکه کد بسیار کوچک را در خطی که پیدا کرده بودم جستجو کنم و پیدایش کنم.

[Professional]

فرمان " IN-LINE AFTER , ADD "

# 
#-----[ IN-LINE AFTER, ADD ]------------------------------------------ 
# 
t.topic_desc,

این فرمان به ما می گوید که شما باید با توجه به فرامین قبل بخشی از کد را پیدا کرده باشدی و با توجه به فرمان inline find باید بخش کوچکی از کد را هم پیدا کرده باشید و حالا باید این بخش از کد را که در این فرمان قرار دارد درست بعد از آن قسمت از کد که در فرمان inline find پیدا کرده بودید , اضافه کنید . به مثال دقت کنید

# 
#-----[ FIND ]------------------------------------------ 
# 
$select_sql = ( !$submit ) ? ", t.topic_title, p.enable_bbcode, p.enable_html, p.enable_smilies, p.enable_sig, p.post_username, pt.post_subject, pt.post_text, pt.bbcode_uid, u.username, u.user_id, u.user_sig" : ''; 
# 
#-----[ IN-LINE FIND ]------------------------------------------ 
# 
t.topic_title, 
# 
#-----[ IN-LINE AFTER, ADD ]------------------------------------------ 
# 
t.topic_desc,

حالا با توجه به فرمان find باید این خط را پیدا کنم که در زیر می نویسم:

$select_sql = ( !$submit ) ? ", t.topic_title, p.enable_bbcode, p.enable_html, p.enable_smilies, p.enable_sig, p.post_username, pt.post_subject, pt.post_text, pt.bbcode_uid, u.username, u.user_id, u.user_sig" : '';

حالا بعد از پیدا کردن این خط با توجه به فرمان inline find باید کدی را که در زیر می نویسم پیدا کنم:

t.topic_title,

حالا بعد از اینکه این قسمت از کد را در خط قبلی پیدا کردم باید به فرمان inline after add عمل کنم و تکه کدی را که در زیر می نویسم به بعد از تکه کد قبلی اضافه کنم:

t.topic_desc,

حالا باید تکه کد اصلی شما به شکل زیر شده باشد :

$select_sql = ( !$submit ) ? ", t.topic_title, t.topic_desc, p.enable_bbcode, p.enable_html, p.enable_smilies, p.enable_sig, p.post_username, pt.post_subject, pt.post_text, pt.bbcode_uid, u.username, u.user_id, u.user_sig" : '';

[Professional]

فرمان " SQL "

این فرمان برای دستکاری و ویرایش بانک اطلاعاتی می باشد و در mod ها به شکل زیر است :

# 
#-----[ SQL ]------------------------------------------ 
# 
ALTER TABLE phpbb_topics ADD topic_desc varchar(255) DEFAULT '' AFTER topic_title

با استفاده از این فرمان می توانید فیلدها و یا جداولی را به دیتابیس اضافه کنید و یا تغییراتی را ایجاد کنید
برای اجرای این فرمان باید وارد cpanel سایت خودتان شوید و وارد phpmyadmin شوید
در آنجا در سمت چپ و پایین صفحه ( در نسخه های قدیمیتر ) یک لینک می بینید به نام Query window که در نسخه های جدید به یک دکمه بسیار کوچک در سمت چپ و بالای صفحه تبدیل شده
باید بر روی این لینک کلیک کنید تا پنجره query باز شود و شما یک پنجره خواهید دید که یک بخش دارد که در آن این کد قرار دارد

SELECT * FROM `phpbb_words` WHERE 1

حالا شما این یک خط کد را به طور کامل از آن پنجره پاک کنید و آن کدی که در mod در قسمت SQL قرار داشت را در این پنجره کپی کنید و دکمه Go را بزنید به عنوان مثال کد زیر:

ALTER TABLE phpbb_topics ADD topic_desc varchar(255) DEFAULT '' AFTER topic_title

بعد از انجام این قسمت میتوانید این پنجره را ببندید و از cpanel خارج شوید .

این بخش از هر mod تنها بخشی هست که فقط باید به شکل آنلاین اجرا بشه و به همین خاطر خطرناکترین بخش هر mod محسوب می شود !