Prestashop快速手册

来自站长百科
跳转至: 导航、​ 搜索

PrestaShop,像所有的PHP脚本语言一样会加载本地服务器上的 index.php 文件。如果你的 Prestashop 商店程序是放在mystore.com,当客户端输入URL : http://www.mystore.com, webserver会自动加载到index 这个页面。

为了了解咋们的Prestashop是如何运行的,我们需要去了解下index文件是如何去工作的。

Index.php[ ]

Prestashop index.php文件中包含着以下的代码 :

 <?php
 include(dirname(__FILE__).'/config/config.inc.php');
 include(dirname(__FILE__).'/header.php');
  
 $smarty->assign('HOOK_HOME', Module::hookExec('home'));
 $smarty->display(_PS_THEME_DIR_.'index.tpl');
  
 include(dirname(__FILE__).'/footer.php');
  
 ?>

在 index.php 文件的开始包含着一个 config.inc.php 的文件,这个文件时主要处理我们的主要设置还有一些程序相关其它设置,config.inc.php 会检查是否所有的东西已经安装好了,并且确认了我们的默认模版和默认目录,还有路径、订单的状态还有其它的一些设置。或者现在你已经在抱怨着什么时候才能开始学习到相关的模版制作,现在我们只知道 index.php 中包含了什么而已。

然而,作为一个网页设计者,你可能需要及时地注意到了网页上的错误信息,因此现在就要用到刚才所提到的 config.inc.php 文件了,在这个文件最上面几行,你可以看到:

  @ini_set('display_errors', 'off');
  你可以选择把它打开或关闭
  @ini_set('display_errors', 'on');

现在你可以关闭错误信息报告了。不过要注意在下次正式安装前要吧它改回来。

Header.php[ ]

下一步,来看看 header.php 的代码:

  <?php
   
  // P3P Policies (http://www.w3.org/TR/2002/REC-P3P-20020416/ compact_policies)
  header('P3P: CP="IDC DSP COR CURa ADMa OUR IND PHY ONL COM STA"');
   
  require_once(dirname(__FILE__).'/init.php');
   
  /* CSS */
  $css_files[_THEME_CSS_DIR_.'global.css'] = 'all';
   
  /* Hooks are voluntary out the initialize array (need those variables already assigned) */
  $smarty->assign(array(
      'HOOK_HEADER' => Module::hookExec('header'),
      'HOOK_LEFT_COLUMN' => Module::hookExec('leftColumn'),
      'HOOK_TOP' => Module::hookExec('top'),
      'static_token' => Tools::getToken(false),
      'token' => Tools::getToken(),
      'priceDisplayPrecision' => _PS_PRICE_DISPLAY_PRECISION_,
      'content_only' => intval(Tools::getValue('content_only'))
  ));
   
  if(isset($css_files) AND !empty($css_files)) $smarty->assign('css_files', $css_files);
  if(isset($js_files) AND !empty($js_files)) $smarty->assign('js_files', $js_files);
   
  /* Display a maintenance page if shop is closed */
  if (isset($maintenance) AND (!isset($_SERVER['REMOTE_ADDR']) OR $_SERVER['REMOTE_ADDR'] != Configuration::get('PS_MAINTENANCE_IP')))
  {
      header('HTTP/1.1 503 temporarily overloaded');
      $smarty->display(_PS_THEME_DIR_.'maintenance.tpl');
      exit;
  }
   
  $smarty->display(_PS_THEME_DIR_.'header.tpl');
   
  ?>

接下来我们可以看到这句代码:

$smarty->assign('HOOK_HOME', Module::hookExec('home'));

这里将会指定分配hook(我们通常都会第一时间把hook给指定分配了,你也可以指定哪些模块在你网站中出现)

$smarty->display(_PS_THEME_DIR_.'index.tpl');

这一行代码是说明 index.tpl 相当于默认主题模版目录的位置(你可以定义或者添加你的主题,backoffice>> preferances>>appearance)

Footer.php[ ]

include(dirname(__FILE__).'/footer.php');

这一行代码include了我们的 footer.php文件,看下footer.php文件代码:

  
  <?php
   
  if (isset($smarty))
  {
      $smarty->assign(array(
          'HOOK_RIGHT_COLUMN' => Module::hookExec('rightColumn'),
          'HOOK_FOOTER' => Module::hookExec('footer'),
          'content_only' => intval(Tools::getValue('content_only'))));
      $smarty->display(_PS_THEME_DIR_.'footer.tpl');
  }
   
  ?>

尽管我们现在了解到了程序的配置设置,hooks还有不同的php文件包含,但是你会发现,目前为止,还没出现我们所熟悉的HTML代码。其实这个就是我们所有templates(tpl)的来源入口。tpl文件里面包含着HTML还有Smarty模版语言。这些tpl文件大多都在你的模版目录下,有些也在每个功能模块目录下。

现在来看看header.php文件,你会看到里面有这些代码:

  $css_files[_THEME_CSS_DIR_.'global.css'] = 'all';
  if(isset($css_files) AND !empty($css_files)) $smarty->assign('css_files', $css_files);
  if(isset($js_files) AND !empty($js_files)) $smarty->assign('js_files', $js_files);
   
  $smarty->display(_PS_THEME_DIR_.'maintenance.tpl');  -  Will display a maintenance page called maintenance.tpl if your shop is closed */
   
  $smarty->display(_PS_THEME_DIR_.'header.tpl');

我们的global.css和cssjavascript文件都被包含在这里,html的显示来自于header.tpl文件。

以此类推,index.php 和footer.php也有这对应的index.tpl和footer.tpl(其它的文件也是这样的命名规则)

现在目前看起来好像有点混乱了,不用担心,坚持下去,接下来会变得简单些的。 好了,从这里开始打段,总结下:index.php文件包含着header.php,index.tpl和footer.tpl,header.php和 footer.php的tpl文件也分别取自他们本身的文件名。

我们主要的HTML代码都来源于这三个tpl文件。

现在我们来打开header.tpl,index,tpl 还有footer.tpl,这里对于web设计师会相对熟悉点

Header.tpl[ ]

   <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
  <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="{$lang_iso}">
      <head>
          <base href="{$protocol}{$smarty.server.HTTP_HOST|escape:'htmlall':'UTF-8'}{$base_dir}" />
          <title>{$meta_title|escape:'htmlall':'UTF-8'}</title>
  {if isset($meta_description) AND $meta_description}
          <meta name="description" content="{$meta_description|escape:htmlall:'UTF-8'}" />
  {/if}
  {if isset($meta_keywords) AND $meta_keywords}
          <meta name="keywords" content="{$meta_keywords|escape:htmlall:'UTF-8'}" />
  {/if}
          <meta http-equiv="Content-Type" content="application/xhtml+xml; charset=utf-8" />
          <meta name="generator" content="PrestaShop" />
          <meta name="robots" content="{if isset($nobots)}no{/if}index,follow" />
          <link rel="icon" type="image/vnd.microsoft.icon" href="{$img_ps_dir}favicon.ico" />
          <link rel="shortcut icon" type="image/x-icon" href="{$img_ps_dir}favicon.ico" />
  {if isset($css_files)}
      {foreach from=$css_files key=css_uri item=media}
      <link href="{$css_uri}" rel="stylesheet" type="text/css" media="{$media}" />
      {/foreach}
  {/if}
          <script type="text/javascript" src="{$base_dir}js/tools.js"></script>
          <script type="text/javascript">
              var baseDir = '{$base_dir}';
              var static_token = '{$static_token}';
              var token = '{$token}';
              var priceDisplayPrecision = {$priceDisplayPrecision*$currency->decimals};
          </script>
          <script type="text/javascript" src="{$base_dir}js/jquery/jquery-1.2.6.pack.js"></script>
          <script type="text/javascript" src="{$base_dir}js/jquery/jquery.easing.1.3.js"></script>
  {if isset($js_files)}
      {foreach from=$js_files item=js_uri}
      <script type="text/javascript" src="{$js_uri}"></script>
      {/foreach}
  {/if}
          {$HOOK_HEADER}
      </head>
    
      <body {if $page_name}id="{$page_name|escape:'htmlall':'UTF-8'}"{/if}>
      {if !$content_only}
          <div id="page">
   
              <!-- Header -->
              <div>
                  <h1 id="logo"><a href="{$base_dir}" title="{$shop_name|escape:'htmlall':'UTF-8'}"><img src="{$img_ps_dir}logo.jpg" 
alt="{$shop_name|escape:'htmlall':'UTF-8'}" /></a></h1>
                  <div id="header">
                      {$HOOK_TOP}
                  </div>
              </div>
   
              <!-- Left -->
              <div id="left_column" class="column">
                  {$HOOK_LEFT_COLUMN}
              </div>
   
              <!-- Center -->
              <div id="center_column">
      {/if}

Index.tpl[ ]

 {$HOOK_HOME}

Footer.tpl[ ]

     {if !$content_only}
              </div>
   
  <!-- Right -->
              <div id="right_column" class="column">
                  {$HOOK_RIGHT_COLUMN}
              </div>
   
  <!-- Footer -->
              <div id="footer">{$HOOK_FOOTER}</div>
          </div>
      {/if}
      </body>
  </html>

现在我们来看看homepage的源文件:

Index.tpl

    !DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
  <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
    <head>
      <base href="http://127.0.0.1/prestashop/" />
      <title>Prestashop demo</title>
      <meta name="description" content="Shop powered by PrestaShop" />
      <meta name="keywords" content="shop, prestashop" />
      <meta http-equiv="Content-Type" content="application/xhtml+xml; charset=utf-8" />
      <meta name="generator" content="PrestaShop" />
      <meta name="robots" content="index,follow" />
      <link rel="icon" type="image/vnd.microsoft.icon" href="/prestashop/img/favicon.ico" />
      <link rel="shortcut icon" type="image/x-icon" href="/prestashop/img/favicon.ico" />
      <link href="/prestashop/themes/commotion/css/global.css" rel="stylesheet" type="text/css" media="all" />
          <script type="text/javascript" src="/prestashop/js/tools.js"></script>
          <script type="text/javascript">
              var baseDir = '/prestashop/';
              var static_token = '8d6a4d79d983512d770333775a7d8d24';
              var token = '521aacf70fb52a35b4f94e01366c4c64';
              var priceDisplayPrecision = 2;
          </script>
          <script type="text/javascript" src="/prestashop/js/jquery/jquery-1.2.6.pack.js"></script>
          <script type="text/javascript" src="/prestashop/js/jquery/jquery.easing.1.3.js"></script>
    </head>
      <body id="index">
              <div id="page">
   
              <!-- Header -->
              <div>
                  <h1 id="logo"><a href="/prestashop/" title="Prestashop demo"><img src="/prestashop/img/logo.jpg" alt="Prestashop demo" /></a></h1>
                  <div id="header">
                    
                  </div>
              </div>
   
              <!-- Left -->
              <div id="left_column" class="column">
                
              </div>
   
              <!-- Center -->
              <div id="center_column">
                       </div>
   
  <!-- Right -->
              <div id="right_column" class="column">
                
              </div>
   
  <!-- Footer -->
              <div id="footer">
          </div>
          </div>
          </body>
  </html>

可能你会注意到了index.tpl 只有一行{$HOOK_HOME}。这里是因为index文件只在homepage上显示我们所指定的模块,我们的目录还有产品页将会显示其它的模块。

当然,你可能也会发现我们每个页面都有一个不同的body id,方便了我们用css去定义他们单独的每个页面,或许你以后还想在body上加上些class,那么这句是从哪句代码得来的呢?看看 header.tpl,这段代码就是用来实现它的:

 <body {if $page_name} 
 id="{$page_name|escape:'htmlall':'UTF-8'}"{/if}> and 
 it is this code that gets the page name. 
 So category.tpl will have the <body id="category">

相关条目[ ]

参考来源[ ]