joomla代码编译入门（创世纪新篇0

采用版本Joomla1.5、

第一步，在administrator/components/下建立com_reviews文件夹，然后创建toolbar.reviews.html.php

代码如下：

第二步，在administrator/components/下建立com_reviews文件夹，然后创建toolbar.reviews.php，代码如下

以上代码是希望得到以下效果：

 先不管，继续做下去，

第三步，创建数据库表

　第四步，既然创建了数据库表，那么接下来自然而然就创建数据库表类，在 administrator/components/com_reviews 文件夹下，创建一个 tables 文件夹，然 
后在里面创建 review.php 文件并输入一下代码：

　　我们继承了 JTable 类，并加入数据表的所有字段作为类的成员变量，成员变量都初始化为 null。然后覆盖类的构造函数 __construct() ，__construct() 会带有一个数据库对象为参数，并调用父类的构造函数，以数据表名（以#__为前缀）、主键和数据库对象为参数值。

      说明：为什么要使用 #__ 为数据表的前缀？ 
      在 Joomla!编写查询和定义 JTable 扩展时，使用 #__ 代替 jos_。Joomla! 执行查询时会自动将 #__ 替换为 管理员选择的数据库前缀。 这样的好处是可以在同一个数据库中运行多套Joomla!。你随便修改数据库的前缀也不用修改代码。TableReview 类继承了  bing()、store()、load() 和  delete() 等函数，这四个函数可以让你不用写一行的 SQL 就可以管理数据库的记录。

第五步，创建好了数据表，我们需要有一个友好的界面来增加点评。添加admin.reivews.php，代码如下：

　　使用  require_once(  JApplicationHelper::getPath(  ‘admin_html‘  )  )  来包含admin.reviews.html.php 文件。getPath() 函数带一个字符串参数并返回与组件文件一致的绝对路径。尽管我们没有指定组件名，但是它会自动包含适当的文件，即使是改变了组件名也一样。使用require_once() 确保文件只被包含一次。
      addIncludePath() 成员函数会包含我们的数据表类，  addIncludePath() 会自动包含所有我们定义在 tables 目录下的数据表类。
      Joomla!设置 JPATH_COMPONENT 为后端代码的绝对路径。  DS 常量是指定的操作系统的目录分隔符。
      editReview() 函数准备了一些 HMTL元素然后传给显示函数 HTML_reviews::editReview()。

第六步，创建 admin.reviews.html.php文件并加入以下代码：

　　在浏览器地址栏输入 http://localhost/joomla/administrator/index.php?option=com_reviews&task=add，然后希望我会看到以下界面效果：

首先，JFactory::getEditor() 函数返回 HTML 编辑器，JHTML::_(‘behavior.calendar’) 函数会在 header 中加入JavaScript 和 CSS ，这是用在点评日期字段中弹出日历的代码： 
class HTML_reviews 
{ 
      function editReview( $row, $lists, $option ) 
     { 
            $editor =& JFactory::getEditor(); 
            JHTML::_(‘behavior.calendar‘); 
编辑器对象的成员函数 display() 返回选择的富文本编辑器的 HTML ， 如果富文本编辑器不存在就返回<textarea> 元素。
display() 函数带有以下的参数：表单变量名、值、宽、高、列数和行数。当没有使用HTML 编辑器，最后两个参数是 <textarea> 的大小。代码片段如下：
<td> 
    <?php 
        echo $editor-->display( ‘quicktake‘,   $row->quicktake , ‘100%‘, ‘150‘, ‘40‘, ‘5‘ ) ; 
    ?> 
</td> 

第七步，管理员填完表单并且当即保存按钮后，我们需要保存信息到数据库里。开始，在admin.reviews.php中创建 saveReview() 函数，代码如下：

　　首先，将全局变量  $mainframe 传进来，  $mainframe 对象提供很多成员函数来控制session 变量和  headers。然后将  TableReview 类的一个实例赋值给 $row ，类的名字由第一个参数和第二个参数组合而成，第二个参数是第一个参数的前缀。

      然后，使用 bind() 成员函数来加载表单中所有变量到 $row 中。

      bind()  函数传一个关联数组参数并且要数组的所有元素都要和对象的成员变量完全匹配。为了减少 SQL注入的风险，我们使用 Jrequest::get() 来清除 $_POST 的值，这个过程会过滤掉所有能够控制 SQL的字符。

     如果 bind() 失败了会弹出一个 JavaScript 的警告对话框并返回到前一个页面。绑定后就可以直接操作 $row 的成员变量。

      既然 quicktake 和 review 字段都接受 HTML内容，那么它们需要对 bind() 函数进行清除 HTML 的特殊处理。
      要做这样处理，可以使用 Jrequest的成员函数getVar()  并传递表单的变量名、默认值、请求的数组、期望的格式和各自JREQUEST_ALLOWRAW 标识。以防点评没有选择日期，我们赋了当前日期给点评日期。

      最后，调用 store() 函数，把所有的成员变量都转化成 UPDATE 和 INSERT 语句（由id 的值决定是 UPDATE 还是 INSERT）。因为是第一次创建记录，id 没有值，所以会构建INSERT 查询语句。 
      如果有 SQL错误就返回上一页， 通常这一类的 SQL错误都是由于 $row额外的成员变量而没有在数据表类中引起的。那么如果发现SQL 错误，第一时间就是要检查确保你的成员变量的拼写要与数据表的列一致。否则，如果  SQL 执行成功，将使用$mainframe 的 redirect() 函数返回组件的页面。

     此时，我们还要在admin.review.php中的switch添加以下代码：

     case ‘save‘:
            saveReview($option);
            break;

     保存文件后访问这个地址：http://localhost/joomla/administrator/index.php?option=com_reviews&task=add你填好表单后点击保存，希望我能看到类似以下的页面：

      现在尝试点击上述页面的“创建”按钮，你会有疑问，为什么我们不能点击“新建”按钮？ 
      工具栏的按钮需要有名字为 adminForm 的表单才能有效，既然现在没有表单，那么点击任何的按钮都产生JavaScript 错误的。当你加上 adminForm 表单后，按钮马上就生效了。

第八步：既然我们的管理员不会有访问 phpMyAdmin 的权限，我们需要创建显示点评的列表。开始 我们在 admin.reviews.php中添加以下函数：

这个函数加载了将被显示的数据，我们得到了一个当前数据库连接的引用， 然后调用它的成员函数 setQuery() ，setQuery() 函数带一个 SQL 语句的字符串为参数，但只做存储之后使用而不是立即执行。当调用 loadObjectList() 函数，之前设置的 SQL 语句就会执行并返回记录到一个数组中。如果运行过程出现错误，那么将显示错误和停止组件运行。

第九步，如果第八步一切正常，那么把记录结果的数组传给  admin.reviews.htlm.php 中的成员函数showReviews()，修改后代码如下：

　　这个函数定义了一个名为 adminForm（作为 JavaScript 应用） 并指向 index.php 的表单，接着显示一个带有  adminlist 类的表格，第一行为表格的头部，第一列是一个复选框“check all”，它会自动地选择页面上的所有记录。
      接着使用传进来的记录数组来循环显示每一行的数组。要注意的是变量 $k，它在每次循环中会在 0 和 1 之中更换值，它的作用好是用来更换每个 <tr> 的类，从而控制了每行显示的背景色。
      大部分的成员变量会直接输出，但是有两个比较特殊，JHTML::(‘grid.id‘) 函数将返回一个能被后端 JavaScript 识别的复选框，JHTML::_(‘grid.published‘)  函数返回一个基于成员变量 published 的值的图片，当  published 的值是  1 时，将返回打勾的图片，否则返回打“X”的图片。 

      在表格下面，有四个隐藏的变量，第一个处理 option 的值，以便路由到正确的组件，第二个是 task，它是在提交表单之前以便让工具栏中的 JavaScript 能给它赋值。第三个是boxchecked，当有任意一行的复选框被选择，boxchecked 被置为 1，当所有行的复选框被清除，boxchecked 被置为 0，它是用来辅助 JavaScript 来处理列表。 
       当完成了 HTML 代码的输出，最后一步就是更新文件 admin.reviews.php中的 switch() 语句，加入下面的高亮代码： 

在浏览器中输入URL路径 http://localhost/joomla/administrator/index.php?

我们将扩展原有的代码来编辑记录， 而不是写一个新的功能。 在文件 admin.reviews.php中的  editReview()  函数中用以下的高亮代码来代替：$row=&JTable:getInstance(‘Review’, ‘Table’)：

　　当执行 editReview() 函数时，我们取得 TableReview 对象来处理数据，然后会从表单中取得记录 ID 的数组变量 cid，既然在同一个时间只编辑一条记录，那我们只选择第一个数组元素来加载相应的记录。更新文件 admin.reviews.php 中的 switch() 语句如下：

　你应该要提供 能够让用户通过点击来编辑各自的记录的链接 。 在文件admin.reviews.html.php 的 HTML_reviews::showReviews() 函数下加入一下高亮的代码：

　   为了兼容 XHTML， 我们需要确保符号 & 使用 &amp; 来代替， 我们使用 ampReplace()来处理 ， 它是  JFilterOutput  类的成员函数 ，  JFilterOutput  通过调用JLoader::import(‘joomla.filter.output‘); 来加载。  Joomla! 提供了许多不同的库， 例如 XML处理和 RSS输出等。我们使用 JLoader::import 函数来按需要加载代码，而不是每次加载Joomla! 时都加载所用的库。

      你可能已经注意到了在编辑页面的工具栏上有个 “应用” 按钮， 它允许人们保存内容的同时，页面依然保留在编辑的状态，为了是应用按钮生效，需要在文件 admin.reviews.php 中做两个改变，在 switch() 语句中加入一下的高亮代码

在 saveReview() 函数中加入 $task 参数：function saveReview( $option, $task )  将 saveReview() 函数的最后一行更改为如下：

　　增加删除的功能是相当的简单，在文件  admin.reviews.php 的  switch()  语句中加入以下的case 语句：

　　当然也要增加 removeReviews() 函数：

　　好了，基本做到这里，组件的后台管理小例子已经完成了

     接下来，我要做做这个组件的前台显示

第一步，在网站根目录/component/创建com_reviews文件夹，在里面创建一个reviews.php的文件，代码如下：

　　与后端的方法相似，require_once(  JApplicationHelper::getPath(  ‘html‘  )  );  导进文件reviews.html.php，传递 JPATH_ADMINISTRATOR.DS.‘components‘.DS.$option.DS.‘tables‘ 到Jtable::addIncludePath();  导进数据表类。 最后 switch()  语句设置了默认的 case 来显示所有发布的点评。这里的 SQL 语句确保只有发布的点评被选择并且以点评日期的倒序来排序。

第二步，在刷新页面之前 ， 我们需要 在  /component/com_reviews/reviews.html.php  中加入HTML_reviews 类：

　　如果你没有写任何的代码来处理 “view” “task”，当你单击一条链接后，你看到的是相同的页面，在 reviews.php 中加入以下代码：

　　先，用 getVar() 获取请求的 id，它能检查变量的各种攻击。外部的数据处理要很小心，特别是处理公共访问的网站的数据，在我们的代码中统一使用 getVar() 将会提供一个合理的安全层。如果 id 的值丢失或者不合法，第二个参数 0 将会作为默认值提供给 id。然后，我们从后端得到一个数据表类，加载相应 id 的记录后，我们检查选择的记录是否被发布，如果不是发布的，我们用  JError 的成员函数 raiseError() 来输出找不到信息的404 页面

这个检查确保不让用户随便输入  id 来获取点评，而且如果记录不存在也会显示以上的页面。viewReview() 函数会做所有的事情来加载请求的点评，但是我们仍然需要加入代码来 
调用这个函数，加入下面的高亮代码到 switch() 中： 

　　我们也需要在我们的输出类创建一个显示函数，在  reviews.html.php 文件中加入showReview() 函数到 HTML_reviews：

　　showReview() 函数传进一个数据库行对象和组件的名字作为参数，这行记录的大部分字段都以 HTML 格式显示，也包含许多逻辑。Smoking 字段陪赋给合适的 Yes 或者 No 值。调用 JHTML::Date() 来格式化从数据库取出来的时间戳。最后，显示一个可以返回点评列表的链接，保存文件后，再次点击点评的链接。

     好了，现在终于前台的文章可以查看了。真是太爽了。

     过了一天，我继续开发“评论”代码块，做做以下记录。

第一步，创建一个评论表，代码如下：

　　第二步，既然有了新的数据库表格，那么我们就要添加一个新的数据库表类了。下面我来做做，在administrator/component/com_reviews文件夹下的tables文件创建comment.php文件，代码如下：

　　第三步，现在我希望得到页面效果是评论在点评详情的下面显示，好了，目标明确，现在我来开发一下，去到根目录/component/com_reviews文件夹，对reviews.html.php进行编辑，添加以下代码高亮部分：

第四步，既然reviews.html.php有了showCommentForm方法，那么我们就应该找个文件写些代码去调用它，所以我就找到根目录/component/com_reviews/reviews.php这个文件，知道了改哪个文件之后，我就要想想改文件的哪个部分，现在我要修改viewReview方法这个部分，修改后代码如下：

　　现在登陆一下：http://localhost/Joomla/index.php，应该可以看到以下类似页面：

　　有了插入数据的方法，那么我要找个地方去调用它，就在reviews.php中的switch块进行控制，现在去改改代码：

第六步，估计这个时候，我可以添加评论数据了。尝试了一下，去数据库表看了一下数据，果然添加成功了。现在我要在前台显示评论的内容，我希望评论跟在文章内容下面，那么，我想好了前台显示的大概效果，现在就来修改一下reviews.html.php的内容了，追加代码如下：

第七步，搞定了前台的显示，那么下一步，就去reviews.php中修改一下viewReview这个方法，代码如下：