دستور ()JFactory::getApplication

همان طور که ما در بررسی کدهای PHP که قالب beez2 را ایجاد کرده اند، به پیش می رویم، به کد زیر می رسیم:

$app                = JFactory::getApplication();

در خط کد بالا، دو آیتم به نام های JFactory و getApplication داریم که در ادامه می خواهیم آنها را بررسی کنیم.

کاربرد JFactory چیست؟

با استفاده از JFactory می توانیم به اشیای بسیاری در هسته ی جوملا دسترسی پیدا کنیم. هنگامی که از JFactory

استفاده می کنید،متغیر شما تبدیل به یک شیء خواهد شد و عموما تنظیمات سایت جوملا 2.5 را در بر دارد.

بر اساس اسناد رسمی جوملا ، اشیای بیشتری نیز وجود دارند که می توانید آنها را فراخوانی نمایید.

دستور ()getApplication چه چیزی را برمی گرداند؟

با استفاده از کد زیر می توانیم محتوای شیء app$ را ببینیم. همان طور که می دانید مقدار app$ برابر با کد

()JFactory::getApplication است.

$app                = JFactory::getApplication();
echo "<pre>"; print_r($app); echo "</pre>"; die();

همان طور که در کدهای زیر می بینید، هنگامی که متغیر app$ را برابر با ()JFactory::getApplication قرار می دهیم ،

اطلاعات زیادی درون این متغیر ذخیره می شوند:

JSite Object ( [template:private] => stdClass Object ( [id] => 4 [home] => 1 [template] => beez_20 [params] => JRegistry Object ( [data:protected] => stdClass Object ( [wrapperSmall] => 53 [wrapperLarge] => 72 [logo] => images/joomla_black.gif [sitetitle] => Joomla! [sitedescription] => Open Source Content Management [navposition] => left [templatecolor] => personal ) ) ) [_language_filter:private] => [_detect_browser:private] => [clientId:protected] => [_clientId:protected] => 0 [messageQueue:protected] => Array ( ) [_messageQueue:protected] => Array ( ) [name:protected] => [_name:protected] => site [scope] => [requestTime] => 2012-07-12 15:36 [startTime] => 1342107374.8458 [input] => JInput Object ( [options:protected] => Array ( ) [filter:protected] => JFilterInput Object ( [tagsArray] => Array ( ) [attrArray] => Array ( ) [tagsMethod] => 0 [attrMethod] => 0 [xssAuto] => 1 [tagBlacklist] => Array ( [0] => applet [1] => body [2] => bgsound [3] => base [4] => basefont [5] => embed [6] => frame [7] => frameset [8] => head [9] => html [10] => id [11] => iframe [12] => ilayer [13] => layer [14] => link [15] => meta [16] => name [17] => object [18] => script [19] => style [20] => title [21] => xml ) [attrBlacklist] => Array ( [0] => action [1] => background [2] => codebase [3] => dynsrc [4] => lowsrc ) [_errors:protected] => Array ( ) ) [data:protected] => Array ( [SESSf61997c271b5d7e7cd0e3d4d2cc7fed5] => oQ8nNIkJD-4hEdP-MWN7foEq6jN2SC6Ww19I9Q26zv8 [jpanesliders_menu-sliders-543] => 0 [jpanesliders_plugin-sliders-433] => 0 [jpanesliders_permissions-sliderscom_users] => 0 [jpanesliders_sliders] => 1 [jpanesliders_plugin-sliders-10067] => 0 [jpanesliders_content-sliders-] => 0 [jpanesliders_permissions-sliders-] => 0 [jpanesliders_menu-sliders-435] => 0 [jpanesliders_content-sliders-79] => 0 [jpanesliders_permissions-sliders-79] => 0 [jpanesliders_permissions-sliderscom_content] => 0 [jpanesliders_menu-sliders-] => 0 [fb8d050fa6edfad9f07b1fb40c8266d0] => 400ef7499e634eb4e7c9cb0d763b22e1 [037affe80d78b62a827b593db7df4c3b] => 91e8e99991ce9f146a26eab8c67f551e [jpanesliders_module-sliders] => 0 [jpanesliders_panel-sliders] => 0 [jpanesliders_position-icon] => 0 [__utma] => 256822360.1859812311.1342025884.1342039063.1342100374.5 [__utmc] => 256822360 [__utmz] => 256822360.1342025884.1.1.utmcsr=(direct)|utmccn=(direct)|utmcmd=(none) [jpanesliders_template-sliders-4] => 0 [option] => com_content [view] => featured [Itemid] => 435 ) [inputs:protected] => Array ( [request] => JInput Object ( [options:protected] => Array ( ) [filter:protected] => JFilterInput Object ( [tagsArray] => Array ( ) [attrArray] => Array ( ) [tagsMethod] => 0 [attrMethod] => 0 [xssAuto] => 1 [tagBlacklist] => Array ( [0] => applet [1] => body [2] => bgsound [3] => base [4] => basefont [5] => embed [6] => frame [7] => frameset [8] => head [9] => html [10] => id [11] => iframe [12] => ilayer [13] => layer [14] => link [15] => meta [16] => name [17] => object [18] => script [19] => style [20] => title [21] => xml ) [attrBlacklist] => Array ( [0] => action [1] => background [2] => codebase [3] => dynsrc [4] => lowsrc ) [_errors:protected] => Array ( ) ) [data:protected] => Array ( [SESSf61997c271b5d7e7cd0e3d4d2cc7fed5] => oQ8nNIkJD-4hEdP-MWN7foEq6jN2SC6Ww19I9Q26zv8 [jpanesliders_menu-sliders-543] => 0 [jpanesliders_plugin-sliders-433] => 0 [jpanesliders_permissions-sliderscom_users] => 0 [jpanesliders_sliders] => 1 [jpanesliders_plugin-sliders-10067] => 0 [jpanesliders_content-sliders-] => 0 [jpanesliders_permissions-sliders-] => 0 [jpanesliders_menu-sliders-435] => 0 [jpanesliders_content-sliders-79] => 0 [jpanesliders_permissions-sliders-79] => 0 [jpanesliders_permissions-sliderscom_content] => 0 [jpanesliders_menu-sliders-] => 0 [fb8d050fa6edfad9f07b1fb40c8266d0] => 400ef7499e634eb4e7c9cb0d763b22e1 [037affe80d78b62a827b593db7df4c3b] => 91e8e99991ce9f146a26eab8c67f551e [jpanesliders_module-sliders] => 0 [jpanesliders_panel-sliders] => 0 [jpanesliders_position-icon] => 0 [__utma] => 256822360.1859812311.1342025884.1342039063.1342100374.5 [__utmc] => 256822360 [__utmz] => 256822360.1342025884.1.1.utmcsr=(direct)|utmccn=(direct)|utmcmd=(none) [jpanesliders_template-sliders-4] => 0 [option] => com_content [view] => featured [Itemid] => 435 ) [inputs:protected] => Array ( ) ) ) ) [_errors:protected] => Array ( ) )

در قالب از متغیر app$ چه استفاده ای می شود؟ 

اکنون می دانیم که متغیر app$ اطلاعات زیادی را دربر دارد اما می خواهیم بدانیم این اطلاعات چه کاربردی در قالب ما دارند؟

برای فهمیدن این نکته، به یک مثال که متغیر app$ در آن به کار رفته است توجه کنید:

$templateparams     = $app->getTemplate(true)->params;

 به نظر می رسد که از متغیر app$ در کد بالا تنها برای گرفتن اطلاعاتی از فایل index.php در قالب beez2، استفاده می شود.

در این مورد، ما از app$ به همراه getTemplate params  استفاده کرده ایم تا ظاهرا پارامتر های قالبمان را به دست بیاوریم.

با استفاده از کد زیر خواهیم دید که چه مقادیری در متغیر templateparams$ ذخیره شده است:

$templateparams     = $app->getTemplate(true)->params;
echo "<pre>"; print_r($templateparams); echo "</pre>"; die();

 نتیجه ی خط کد بالا تایید می کند که متغیر templateparams$ مقادیر پارامترهای قالب را دربر دارد:

JRegistry Object
(
    [data:protected] => stdClass Object
        (
            [wrapperSmall] => 53
            [wrapperLarge] => 72
            [logo] => images/joomla_black.gif
            [sitetitle] => Joomla!
            [sitedescription] => Open Source Content Management
            [navposition] => left
            [templatecolor] => personal
        )

)

 از مقادیر قرمز رنگ بالا در کدهای زیر استفاده می کنیم (که در مقاله ی قبلی از آنها استفاده نمودیم):

// get params
$color              = $this->params->get('templatecolor');
$logo               = $this->params->get('logo');
$navposition        = $this->params->get('navposition');

در نهایت می توان گفت که از دستور templateparams$ به صورت زیر استفاده می شود:

$templateparams->get('sitetitle');
$templateparams->get('sitedescription');

چرا از دستور JFactory::getApplication در قالب خود استفاده کنیم؟ 

در بالا به شما نشان دادیم که چطور از دستور JFactory::getApplication در قالب خود استفاده کنید، اکنون می خواهیم به شما نشان دهیم که چرا از آن استفاده کنیم:

1. از دستور JFactory::getApplication برای ایجاد متغیری به نام app$ استفاده می کنیم:

$app = JFactory::getApplication();

2. سپس از متغیر app$ برای ایجاد متغیر templateparams$ استفاده می کنیم:

$templateparams = $app->getTemplate(true)->params;

3. در آخر نیز از متغیر templateparams$ برای به دست آوردن مقادیر زیر استفاده می کنیم:

$templateparams->get('sitetitle')

و ...

$templateparams->get('sitedescription')

بنا براین در پایان، به نظر می رسد که از دستور getApplication برای به دست آوردن title(عنوان) سایت و description(توضیحات)سایت استفاده می شود.  

منبع مقاله

• قبلی
• بعدی