Hamidy در ‏۴ اوت ۲۰۱۳، ساعت ۰۳:۴۴

2013-08-04T03:44:46Z

Shmata: صفحه‌ای جدید حاوی «=مقدمه= پلاگین های [http://www.joomlafarsi.com جوملا] امکان اجرای یک قطعه کد را زمانیکه ...» ایجاد کرد

2013-08-03T07:20:16Z

صفحه‌ای جدید حاوی «=مقدمه= پلاگین های [http://www.joomlafarsi.com جوملا] امکان اجرای یک قطعه کد را زمانیکه ...» ایجاد کرد

صفحهٔ تازه

=مقدمه=
[[پلاگین]] های [http://www.joomlafarsi.com جوملا] امکان اجرای یک قطعه کد را زمانیکه رویداد (event) خاصی اتفاق بیوفتد فراهم میکنند. همچنین [[پلاگین]] ها امکان تقابل و فعل و انفعال با [[کامپوننت]] ها و [[ماژول]] های [[جوملا]] را دارند یعنی بدون اینکه در داخل کدهای [[کامپوننت]] ها و [[ماژول]] ها تغییری ایجاد شود. با استفاده [[پلاگین]] ها امکان ایجاد تغییرات در عملکرد این افزونه ها امکان پذیر است. در داخل هسته [[جوملا]] مجموعه معین ازپیش تعریف شده ای از رویداد های [[پلاگین]] ها از پیش تعریف شده است. بطوریکه یک رویداد اتفاق میافتد تمام توابع مربوط به رویداد یا رویداد ها به ترتیب میشوند. از این رو برای توسعه [[جوملا]] شناسایی رویداد های مربوط به [[پلاگین]] ها و موقعیتی آنها در فایلها قرار دارند اهمیت دارد.
<br/>
با توجه به سیستم نام گذاری استاندارد [[جوملا]] عملکرد کلیه رویدادها با توجه به نام آنها مشخص است. ما در این مقاله انواع [[پلاگین]] ها و رویدادهایی که از قبل تعریق شده است را صرفا معرفی خواهیم کرد.
=انواع پلاگین ها=
* [[پلاگین]] های سیستمی (System Plugin)
* [[پلاگین]] های محتوا (Content Plugin)
* [[پلاگین]] های کاربری (User Plugin)
* [[پلاگین]] های اعتبارسنجی (Authentication Plugin)
* [[پلاگین]] های ویرایشگر (Editors Plugin)
* [[پلاگین]] های جستجو (Search Plugin)
* [[پلاگین]] های تماس (Contact Plugin)
=رویداد های وابسته به پلاگین های سیستم=
<div dir="ltr">
1) onBeforeRender()
<br/>
2) onAfterRender()
<br/>
3) onAfterRoute()
<br/>
4) onAfterDispatch()
</div>
این رویدادها در کلاس '''JAdministrator''' در فایل '''application.php''' قرار دارند از در مسیر
<div dir="ltr">
Joomla_Root\administrator\includes
</div>
در دسترس میباشند.
<div dir="ltr">
5) onAfterInitialise()
</div>
این رویداد در کلاس '''JAdministrator''' در فایل '''application.php''' قرار دارند از در مسیر
<div dir="ltr">
Joomla_Root\libraries\joomla\application
</div>
در دسترس میباشند.
=رویدادهای وابسته به پلاگین محتوا=
<div dir="ltr">
1) onContentPrepare($context, &$item, &$params, $offset)
<br/>
2) onContentAfterTitle($context, &$item, &$params, $offset)
<br/>
3) onContentBeforeDisplay($context, &$item, &$params, $offset)
<br/>
4) onContentAfterDisplay($context, &$item, &$params, $offset)
</div>
این رویدادها در کلاس '''ContentViewArticle''' در فایل '''view.html.php''' قرار دارند از در مسیر
<div dir="ltr">
Joomla_Root\components\com_content\views\article
</div>
در دسترس میباشند.
<br/>
'''item$''' = این یک اشاره گر به مطلبی است که در View ساخته میشود.
<br/>
'''params$''' = این یک اشاره گر به آرایه ای که است با پارامترهای مشخص شده توسط Viewدر ارتباط است.
<br/>
'''offset$''' = یک عدد از نوع integer است که مشخص کننده صفحه ای از مطلب تولید شده است.
<br/>
'''context$''' = یک متن مشخص است.
<div dir="ltr">
5) onContentPrepareForm($form, $data)
<br/>
6) onContentPrepareData($context, $data)
</div>
این رویدادها در کلاس '''ContactModelContact'''در فایل '''contact.php''' قرار دارند از در مسیر
<div dir="ltr">
Joomla_Root\components\com_contact\models
</div>
در دسترس میباشند.
<br/>
'''form$''' = یک شی JForm است که نمایش داده میشود.
<br/>
'''data$''' = یک شی شامل داده هایی برای فرم است.
<br/>
'''context$''' = یک متن مشخص است.
=پلاگین های کاربری=
<div dir="ltr">
1) onUserLogin($response, $options)
<br/>
2) onUserLoginFailure($response)
<br/>
3) onUserLogout($parameters, $options)
<br/>
4) onUserLogoutFailure($parameters)
</div>
این رویدادها در کلاس '''JApplication''' در فایل '''application.php''' قرار دارند از در مسیر
<div dir="ltr">
Joomla_Root\libraries\joomla\application
</div>
در دسترس میباشند.
<div dir="ltr">
5) onUserBeforeSave($getproperties, $isNew, $properties)
<br/>
6) onUserAfterSave($getproperties, $isNew, $result, $error)
<br/>
7) onUserBeforeDelete($getproperties)
<br/>
8) onUserAfterDelete($getproperties,$result, $error)
</div>
این رویدادها در کلاس '''JUser''' در فایل '''user.php''' قرار دارند از در مسیر
<div dir="ltr">
Joomla_Root\libraries\joomla\user
</div>
در دسترس میباشد.
=پلاگین های اعتبارسنجی=
<div dir="ltr">
1) onUserAuthorisation($response, $options)
</div>
این رویداد در کلاس '''JAuthentication''' در فایل '''authentication.php''' قرار دارد از در مسیر
<div dir="ltr">
JoomlaRoot\libraries\joomla\user
</div>
در دسترس می باشد.
<br/>
'''response$''' = شامل اطلاعات نام کاربری user ایکه اعتبار سنجی شده.
<br/>
'''options$''' = شامل لیستی از option ها.
<div dir="ltr">
2) onUserAuthorisationFailure($authorisation)
</div>
این رویداد در کلاس '''JApplication''' در فایل '''application.php''' قرار دارد از در مسیر
<div dir="ltr">
JoomlaRoot\libraries\joomla\application
</div>
در دسترس میباشد.
=پلاگین ویرایشگر=
<div dir="ltr">
1) onInit()
<br/>
2) onSave($id)
<br/>
3) onSetContent($id)
<br/>
4) onCustomEditorButton (editors-xtd)
<br/>
5) onDisplay($name, $content, $width, $height, $col, $row, $buttons = true, $id = null, $asset = null, $author = null, $params = array())
<br/>
6) onGetContent($id)
<br/>
7) onGetInsertMethod($name)
</div>
=پلاگین جستجو=
<div dir="ltr">
1) onContentSearch($keyword,$match,$ordering,$areas)
<br/>
2) onContentSearchAreas()
</div>
این رویدادها در کلاس '''SearchModelSearch''' در فایل '''search.php''' قرار دارد از در مسیر
<div dir="ltr">
JoomlaRoot\components\com_search\models
</div>
در دسترس می باشند.
=پلاگین تماس =
این رویدادها هنگامیکه با فرم تماس ([[کامپوننت]] تماس) کار میکنید اجرا میشوند . این رویداد ها در کلاس '''ContactControllerContact''' و در فایل '''contact.php''' قرار دارد و از مسیرزیر در دسترس میباشند.
<div dir="ltr">
1) onSubmitContact(&$contact, &$data)
</div>
زمانیکه فرم اعتبار سنجی شد اجرا میشود
<div dir="ltr">
2)onValidateContact(&$contact, &$data)
</div>
جهت اعتبار سنجی مورد استفاده قرار میگیرد به عبارت دیگر رویدادهای بالا میتوانند برای اعتبار سنجی و captcha هم مورد استفاده قرار گیرند.
<br/>
contact$ = شامل یک اشاره گر به کاربری که اطلاعاتی را در فرم تماس ارسال کرده.
<br/>
data$ = شامل اشاره گر به متغیری که توسط متد POST دریافت میشود و به شکل زیر مورد استفاده قرار میگیرد.
<source lang="php">
$data=JRequest::getVar('jform, array(), 'post','array');
</source>

----

جمع آوری شده توسط :[http://forum.joomlafarsi.com/members/26237-shmata شهاب مطاع پور]

{{آموزش}}

{{معرفی پشتیبانی}}

{{کپی رایت}}

[[رده:پلاگین جوملا 2.5]] [[رده: سوالات متداول جوملا 2.5]] [[رده: کدنویسی و گسترش جوملا 2.5]][[رده: مقالات جوملا 2.5]]

معرفی پلاگین ها و رویدادها - تاریخچهٔ ویرایش‌ها

Hamidy در ‏۴ اوت ۲۰۱۳، ساعت ۰۳:۴۴

Shmata: صفحه‌ای جدید حاوی «=مقدمه= پلاگین های [http://www.joomlafarsi.com جوملا] امکان اجرای یک قطعه کد را زمانیکه ...» ایجاد کرد