大家好！欢迎来到我们开发系列的最后一部分代码部分。如果你从开头一直跟到这里，你现在已经走过了创建原生Joomla! 3.x系列扩展的代码开发过程。这是一个漫长的过程，但希望也是一个既令人满意又富有信息量的过程。我在过去这些文章中很高兴有机会与大家分享Joomla扩展开发的技巧和窍门。在这篇最后的开发文章中，我们将探讨一些最后的想法，进行一些整理，并讨论未来可以添加的额外功能。现在，请准备好，我们将深入最后一篇关于Joomla 3.x组件开发的文章。

  步骤0：制作咖啡

是的，你说对了。和之前每一篇开发文章一样，我们将会从一杯新鲜的咖啡开始。我们将开始让大脑为编写代码做好准备，并开始专注于手头的任务。希望这篇文章不会像之前的文章那么详细，因此我相信不需要额外的咖啡，并且希望你能在这篇教程结束时还有咖啡喝。

  步骤1：编写管理面板

当前Joomla管理员面板有各种用途，并且有几种不同的方式可以最有效地使用它。可以认为管理员面板是每个组件根据需要使用的独特机会。我们编写了Lendr作为前端应用程序，组件的大部分功能和目的都是由前端用户利用的。由于这种情况，我们将仅在Lendr中使用管理员面板来提供额外功能和一些基本选项设置。这样，我们将在管理员组件模型、视图和控制器中避免存储重复代码，同时我们仍将继续能够演示管理员侧的正确代码结构。希望通过遵循这种方法，您能够理解何时以及如何最有效地使用管理员面板。

为管理员侧代码创建了以下文件：一个帮助文件、一个控制器、一个模型、一个视图、一个访问文件、一个配置文件和我们的语言文件。

我们将逐一处理这些文件，从主要入口点：lendr.php开始。

joomla_root/administrator/components/com_lendr/lendr.php

<?php // No direct access
defined( '_JEXEC' ) or die( 'Restricted access' );
//load classes
JLoader::registerPrefix('Lendr', JPATH_COMPONENT_ADMINISTRATOR);
//Load plugins
JPluginHelper::importPlugin('lendr');
 
//application
$app = JFactory::getApplication();
 
// Require specific controller if requested
$controller = $app->input->get('controller','display');
// Create the controller
$classname  = 'LendrControllers'.ucwords($controller);
$controller = new $classname();
 
// Perform the Request task
$controller->execute();
              

joomla_root/administrator/components/com_lendr/controllers/display.php

<?php defined( '_JEXEC' ) or die( 'Restricted access' ); 
 
class LendrControllersDisplay extends JControllerBase
{
  public function execute()
  {
    // Get the application
    $app = $this->getApplication();
 
    // Get the document object.
    $document     = JFactory::getDocument();
 
    $viewName     = $app->input->getWord('view', 'statistics');
    $viewFormat   = $document->getType();
    $layoutName   = $app->input->getWord('layout', 'default');
    $app->input->set('view', $viewName);
 
    // Register the layout paths for the view
    $paths = new SplPriorityQueue;
    $paths->insert(JPATH_COMPONENT . '/views/' . $viewName . '/tmpl', 'normal');
 
    $viewClass  = 'LendrViews' . ucfirst($viewName) . ucfirst($viewFormat);
    $modelClass = 'LendrModels' . ucfirst($viewName);
    $view = new $viewClass(new $modelClass, $paths);
    $view->setLayout($layoutName);
    // Render our view.
    echo $view->render();
 
    return true;
  }
}

您应该立即注意到此控制器与默认前端控制器之间的相似之处。我们在两个中都执行类似任务。在这种情况下，我们设置的默认视图与前端不同。

接下来，我们将检查位于默认视图（如前所述，默认视图被标记为statistics）内的html.php文件夹。

/joomla_root/administrator/components/com_lendr/views/statistics/html.php

>?php defined( '_JEXEC' ) or die( 'Restricted access' ); 
 
class LendrViewsStatisticsHtml extends JViewHtml
{
  function render()
  {
    $app = JFactory::getApplication();
   
    //retrieve task list from model
    $model = new LendrModelsStatistics();
    $this->stats = $model->getStats();
    $this->addToolbar();
    //display
    return parent::render();
  } 
    /**
     * Add the page title and toolbar.
     *
     * @since   1.6
     */
    protected function addToolbar()
    {
        $canDo  = LendrHelpersLendr::getActions();
        // Get the toolbar object instance
        $bar = JToolBar::getInstance('toolbar');
        JToolbarHelper::title(JText::_('COM_LENDR_STATISTICS'));
               
        if ($canDo->get('core.admin'))
        {
            JToolbarHelper::preferences('com_lendr');
        }
    }
}
            

此文件有几个新元素，所以我们将对它进行更深入的探讨。首先请注意，我们正在继承JViewHtml类。这为我们提供了一些基本功能，您可以在Joomla库文件夹中直接查看JViewHtml类以找到这些功能。然后我们有对模型的标准调用，以加载我们视图所需的特定数据。

接下来，我们有一行新代码。addToolbar函数位于此文件中，通常用于向组件管理员侧的顶部工具栏添加元素。由于我们只进行基本的行政面板，功能有限，因此我们的工具栏中只有一个项目。

最后，我们渲染视图，就像在前端一样。

如前所述，addToolbar函数添加了按钮到组件中的子导航顶部工具栏。由于我们没有将完整的一组视图和功能集成到我们的行政面板示例中，因此我们在此情况下只有一个按钮。我们首先要做的是创建标准Joomla工具栏类的实例，然后将我们的标题和按钮分配给此实例。

注意，我们的语言文件被用于所有语言字符串。如果我们想在组件标题旁边显示一个图像，我们只需在定义标题行时传递第二个引用。

在此函数中，我们还调用了我们的帮助类。现在是一个回顾该帮助类的作用及其使用方法的好时机。这个帮助类包含了一些在组件管理中使用的有用功能。

joomla_root/administrator/components/com_lendr/helpers/lendr.php

<?php
/**
 * @package     Joomla.Administrator
 * @subpackage  com_lendr
 *
 * @copyright   Copyright (C) 2005 - 2013 Open Source Matters, Inc. All rights reserved.
 * @license     GNU General Public License version 2 or later; see LICENSE.txt
 */
defined('_JEXEC') or die;
/**
 * Lendr component helper.
 *
 * @package     Joomla.Administrator
 * @subpackage  com_lendr
 * @since       1.6
 */
class LendrHelpersLendr
{
  public static $extension = 'com_lendr';
  /**
   * @return  JObject
   */
  public static function getActions()
  {
    $user = JFactory::getUser();
    $result = new JObject;
    $assetName = 'com_lendr';
    $level = 'component';
    $actions = JAccess::getActions('com_lendr', $level);
    foreach ($actions as $action)
    {
      $result->set($action->name, $user->authorise($action->name, $assetName));
    }
    return $result;
  }
}
          

在这个辅助函数中，我们目前有一个函数。getActions 函数将使用存储在组件管理员根目录下的 access.xml 文件。这是一个很好的功能，它只需加载 XML 中找到的值即可创建一个对象。

让我们花一点时间来看看 access.xml 文件，并了解它如何与组件中将要使用到的功能相关联。

joomla_root/administrator/components/com_lendr/access.xml

<?xml version="1.0" encoding="utf-8"?>
<access component="com_lendr">
  <section name="component">
    <action name="core.admin" title="JACTION_ADMIN" description="JACTION_ADMIN_COMPONENT_DESC" />
  </section>
</access>

为了本教程的目的，我们有一个非常简化的访问文件。基本上，我们只是查找是否有管理员权限。我们将使用管理员级别的访问权限来确定用户是否有能力查看管理员组件子菜单中的选项（我们在本教程之前开始的地方）。这里可以添加更多部分和动作，也可以添加自定义动作。这和 Joomla 2.5 中的内容相同，如果感兴趣，建议查看那些教程的细节。

这使我们来到了这一步骤的第二部分。组件选项。

<?xml version="1.0" encoding="utf-8"?>
<config>
  <fieldset name="component"
    label="COM_LENDR_OPTIONS"
    description="COM_LENDR_OPTIONS_DESC"
  >
    <field name="required_account" type="radio"
      default="0"
      class="btn-group"
      label="COM_LENDR_REQUIRED_ACCOUNT"
      description="COM_LENDR_REQUIRED_ACCOUNT_DESC">
      
      <option value="0">JNO</option>
      <option value="1">JYES</option>
    </field>
    <field name="new_reviews" type="radio"
      default="1"
      class="btn-group"
      label="COM_LENDR_ALLOW_NEW_REVIEWS"
      description="COM_LENDR_ALLOW_NEW_REVIEWS_DESC">
      
      <option value="0">JNO</option>
      <option value="1">JYES</option>
    </field>
    <field name="new_wishlists" type="radio"
      default="1"
      class="btn-group"
      label="COM_LENDR_ALLOW_NEW_WISHLISTS"
      description="COM_LENDR_ALLOW_NEW_WISHLISTS_DESC">
      
      <option value="0">JNO</option>
      <option value="1">JYES</option>
    </field>
    <field name="new_waitlists" type="radio"
      default="1"
      class="btn-group"
      label="COM_LENDR_ALLOW_NEW_WAITLISTS"
      description="COM_LENDR_ALLOW_NEW_WAITLISTS_DESC">
      
      <option value="0">JNO</option>
      <option value="1">JYES</option>
    </field>
  </fieldset>
  <fieldset name="permissions"
    description="JCONFIG_PERMISSIONS_DESC"
    label="JCONFIG_PERMISSIONS_LABEL"
  >
    <field name="rules" type="rules"
      component="com_lendr"
      filter="rules"
      validate="rules"
      label="JCONFIG_PERMISSIONS_LABEL"
      section="component" />
  </fieldset>
</config>

// Line 11 - 19
 $params = JComponentHelper::getParams('com_lendr');
    if ($params->get('required_account') == 1) 
    {
        $user = JFactory::getUser();
        if ($user->get('guest'))
        {
            $app->redirect('index.php',JText::_('COM_LENDR_ACCOUNT_REQUIRED_MSG'));
        }
    }

// Line 43 - 48
<?php if($this->params->get('new_wishlists') == 1 ): ?>
                      <li><a href="javascript:void(0);" onclick="addToWishlist('<?php echo $this->book->book_id; ?>');"><?php echo JText::_('COM_LENDR_ADD_WISHLIST'); ?></a></li>
                    <?php endif; ?>
                    <?php if($this->params->get('new_reviews') == 1 ): ?>
                      <li><a href="#newReviewModal" data-toggle="modal"><?php echo JText::_('COM_LENDR_WRITE_REVIEW'); ?></a></li>
                    <?php endif; ?>

  第2步：代码清理

这里我们将快速审查代码清理的两个方面。首先，我们需要添加删除对象的能力，其次我们需要有一个列表视图来显示系统中的所有书籍。

joomla_root/components/com_lendr/controllers/delete.php

<?php defined( '_JEXEC' ) or die( 'Restricted access' ); 
 
class LendrControllersDelete extends JControllerBase
{
  public function execute()
  {
    $app = JFactory::getApplication();
    $return = array("success"=>false);
    
    $type = $app->input->get('type','waitlist');
   
    $modelName = 'LendrModels'.ucfirst($type);    
    $model = new $modelName();
    if ( $row = $model->delete() )
    {
      $return['success'] = true;
      $return['msg'] = JText::_('COM_LENDR_BOOK_DELETE_SUCCESS');
    }else{
      $return['msg'] = JText::_('COM_LENDR_BOOK_DELETE_FAILURE');
    }
    echo json_encode($return);
  }
}

在我们的删除控制器中（因为每个控制器都是一个单一的操作）我们有一个将数据传递给适当的模型进行处理的函数。在这里，我们根据JInput变量中的类型值配置模型名称。模型是我们将实际删除项的地方。

joomla_root/components/com_lendr/models/book.php

 /**
  * Delete a book
  * @param int      ID of the book to delete
  * @return boolean True if successfully deleted
  */
  public function delete($id = null)
  {
    $app  = JFactory::getApplication();
    $id   = $id ? $id : $app->input->get('book_id');
    $book = JTable::getInstance('Book','Table');
    $book->load($id);
    $book->published = 0;
    if($book->store()) 
    {
      return true;
    } else {
      return false;
    }
  }

删除一本书是我们软删除而不是永久删除对象的一个例子。代码非常简单，如上所示。我们将找到我们希望删除的书的ID，然后获取Book表的一个实例并加载相应的行。一旦我们加载了行，我们可以轻松地将发布状态设置为0，然后存储结果。如果行存储成功，我们将向javascript返回一个true值，或者如果存储失败，我们将返回一个false。

我们将查看的第二个删除项目的位置是等待列表模型。

joomla_root/components/com_lendr/models/waitlist.php

/**
  * Delete a book from a waitlist
  * @param int      ID of the book to delete
  * @return boolean True if successfully deleted
  */
  public function delete($id = null)
  {
    $app  = JFactory::getApplication();
    $id   = $id ? $id : $app->input->get('waitlist_id');
    if (!$id)
    {
      if ($book_id = $app->input->get('book_id')) 
      {
        $db = JFactory::getDbo();
        $user = JFactory::getUser();
        $query = $db->getQuery(true);
        $query->delete()
            ->from('#__lendr_waitlists')
            ->where('user_id = ' . $user->id)
            ->where('book_id = ' . $book_id);
        $db->setQuery($query);
        if($db->query()) {
          return true;
        }
      } 
    } else {
      $waitlist = JTable::getInstance('Waitlist','Table');
      $waitlist->load($id);
      if ($waitlist->delete()) 
      {
        return true;
      }      
    }
    return false;
  }

在这个例子中，我们实际上是从数据库表中硬删除行。我们这样做的原因是因为在这个数据中没有发布列，因此删除选项被认为是合适的。

与之前提到的书籍删除示例一样，如果有一个特定的等待列表ID，我们可以加载该特定对象并直接删除它。如果没有特定的等待列表ID，我们可以使用书ID和人员的用户ID查找必要的行，然后删除相关行。

在Lendr中，我们通过AJAX调用处理删除书籍，因此当我们点击删除按钮时，我们希望自动从我们正在查看的页面上删除相关的行。以下是处理AJAX调用和随后删除行的javascript。

joomla_root/components/com_lendr/assets/js/lendr.js

function deleteBook(book_id,type) 
{
  jQuery.ajax({
    url:'index.php?option=com_lendr&controller=delete&format=raw&tmpl=component',
    type:'POST',
    data: 'book_id='+book_id+'&type='+type,
    dataType: 'JSON',
    success:function(data)
    {
      alert(data.msg);
      if(data.success)
      {
        jQuery("tr#bookRow"+book_id).hide();
      }
    }
  });
}

在这里，我们传递了book_id和类型 - 类型对于在删除控制器中使用非常重要，正如我们之前所见（记住：这是我们如何将任务路由到适当的模型）。然后我们将显示由删除控制器生成的结果警告消息，如果删除成功，我们将从列表视图中删除相关的行。我们通过仅使用jQuery隐藏行来删除行。表行ID由bookRow定义，而特定书籍的ID（这是一个唯一标识符）。

// Lines 8 - 19
    $layout = $this->getLayout();
    $this->params = JComponentHelper::getParams('com_lendr');
    //retrieve task list from model
    $model = new LendrModelsBook();
    if($layout == 'list')
    {
        $this->books = $model->listItems();
        $this->_bookListView = LendrHelpersView::load('Book','_entry','phtml');
    } else {
  …
          

<table cellpadding="0" cellspacing="0" width="100%" class="table table-striped">
  <thead>
    <tr>
      <th><?php echo JText::_('COM_LENDR_DETAILS'); ?></th>
      <th><?php echo JText::_('COM_LENDR_STATUS'); ?></th>
      <th><?php echo JText::_('COM_LENDR_ACTIONS'); ?></th>
    </tr>
  </thead>
  <tbody id="book-list">
    <?php for($i=0, $n = count($this->books);$i<$n;$i++) { 
            $this->_bookListView->book = $this->books[$i];
            $this->_bookListView->type = 'book';
            echo $this->_bookListView->render();
    } ?>
  </tbody>
</table>
          

  第3步：菜单和文件清理

我们将审查这个步骤的两个部分。第一部分涉及创建和定义可能的菜单链接入口点，用于在管理员面板中创建菜单链接。第二部分将包括一些不必要的文件和/或函数的轻微删除。

<?xml version="1.0" encoding="utf-8"?>
<metadata>
  <layout title="COM_LENDR_PROFILE_LIST">
    <message><![CDATA[COM_LENDR_PROFILE_LIST_DESC]]></message>
  </layout>
</metadata>
          

COM_LENDR = Lendr
COM_LENDR_SETTINGS = Lendr Settings
COM_LENDR_PROFILE_LIST = Profile List
COM_LENDR_PROFILE_LIST_DESC = Display list of all profiles
COM_LENDR_BOOK_LIST = Book List
COM_LENDR_BOOK_LIST_DESC = Display list of all books

  第4步：额外建议

以下是一些额外的建议，如果对这些建议中的任何一项或全部感兴趣，可以在未来的文章中作为本系列的补充。其中一些想法是全新的、前沿的机会，可以为Joomla 3.x组件提供新的功能。如果你对其中的一些建议感兴趣，请在评论区留言。

标签

标签是Joomla 3.1的新功能。通过标签，可以将标签分配给书籍，然后可以根据这些标签搜索和分组书籍。标签还可以允许书籍被分配到多个标签，以便进行过滤和排序。

分类

分类将提供将书籍添加到特定分类的机会。这允许进行大规模的分组，并展示了如何使用Joomla分类结构和演示使用Joomla分类的正确方法。

网络服务 / JSON

使用基本的网络服务模型，我们可以演示直接从Lendr组件中检索数据的方法，而无需使用标准的组件视图和布局。以JSON格式检索数据，以便在其他系统中使用。

下一篇文章：维护发布

正如我提到的，这篇文章代表了这个系列的最后一部分严肃的编码，然而在下一个版本中，我们将讨论一些维护发布和支持组件的想法。我们将探讨GitHub和分发方法，以及版本号约定、发布时间表等。