K官方教程-中文版

1、K2官方教程中文版 导读：就爱阅读网友为您分享以下“K2官方教程中文版”资讯，希望对您有所帮助，感谢您对92的支持!K2官方教程中文版JOOMLA粉丝网（ ）收集整理 K2官方教程中文版 #00教程相关说明 2#01 K2安装及设置快速指南 2#02 K2模板覆盖及子模板创建 3#03 创建菜单链接 4#04 使用K2创建Joomla 首页 5#05 K2首页面板(dashboard) 7#06 理解K2工作原理 8#07 创建内容分类 10#08 创建额外属性域 11#09 创建内容条目 12#10 分类参数详解 - 内容布局 13#11 分类参数详解 - 分类页面设置 . 15#12 K2

2、模板设置 . 17 K2官方教程中文版JOOMLA粉丝网（ ）收集整理 #00 教程相关说明 教程来源：本教程源自K2官方，由Viiiix7210（）翻译，经JOOMLA 粉丝网（ ）站长rain 收集整理而成。 版权声明：Joomla 粉丝网整理本教程只是为了方便大家学习使用K2，版权归官方和译者所有，特此声明。 #01 K2安装及设置快速指南 K2是一款由JoomlaWorks 开发的Joomla 内容组件，为Joomla 带来了类似CCK(Content Construction Kit) 的功能；这里是JED 中的K2索引页面，包括详细功能特色及截图演示等。通过K2，我们可以使用更现代

3、的方式来管理内容，将我们的Joomla 站点打造成博客、分类名录或杂志型网站等。下面是K2在安装及设置方面的快速指南，参考这些步骤，我们可以很容易的上手K2。 1. 到 下载最新版本的K2。2. 通过Joomla 的扩展管理安装K2组件。3. 安装成功后，通过Joomla 的组件菜单进入K2首页面板。4. 创建Extra Field Groups ，根据自己的内容需求进行命名，例如Blog 、Catalog(名录) 、Directory(目录) 等；大致的原则，就是每一个Extra Field Group 都针对一种内容类别。5. 根据我们的内容所包含的属性需求，为不同类别的内容创建Extra

4、 Fields，并分配到相应的Extra Field Group 中。默认共有6种类别的fields ，分别是text field 、textarea 、下拉菜单、多选菜单、单选按钮及链接，用来创建不同类别的内容额外属性。6. 为我们的内容创建分类(Categories)，并为每个分类绑定对应的Extra Field Group。7. 创建用户群组(User Groups)。K2自带两个组别的用户：注册用户(Registere)和网站拥有者(Site Owner)。在群组设定页面中有相应的权限设定(Permissions)，例如，如果我们需要某个组别的用户有权限在站点前台发布内容，那么可以将“

5、Front-end itemediting”和“Add items”设置为“Yes”；如果希望这些用户只能编辑自己发布的内容，那么将“Edit own items”设置为“Yes”，而“Edit All items”可以允许用户编辑全部内容。“Publish items”和“Post comments”分别用来设置用户发布内容和发布评论的权限。8. 创建好用户群组并设置好相关权限后，就可以将现有的注册用户分配到相应的组别中了，并可以为他们添加性别、描述、头像等个人信息。这些信息将显示在用户发表的内容的下面。9. 可以预先为能够预计到的内容创建一些tag 标签。10. 在Joomla 的菜单管理

6、中创建新的菜单项并根据需要选择K2组件的不同类别，其中： K2官方教程中文版JOOMLA粉丝网（ ）收集整理 “Item”类型对应着通过K2创建的某个单篇内容。 “Categories”会陈列出通过K2创建的某分类中的内容。 “Tag”用来显示通过K2创建的包含某tag 标签的全部内容。 “User Page(blog)”用来显示某用户的个人页面，内容将以blog 的形式输出。11. 根据需求，可以在模块管理中创建或发布K2登录模块、K2评论模块或K2内容模块，用来显示基于K2用户管理机制的登录表单、评论及评论表单、内容列表输出。12. 整体架构出来之后，开始为不同的内容类别添加具体的内容(i

7、tem)。 #02 K2模板覆盖及子模板创建我们知道，Joomla 1.5是通过MVC 方式开发的内容管理系统，我们可以使用模板覆盖的方式来自定义扩展的输出。对于组件来说，典型的模板覆盖方式是将组件路径中的tmpl 文件夹复制并粘贴至自己的模板文件夹中，最终路径大致为：当前模板文件夹/html/com_componentName/；在过去的K2 1.0版本中，我们也使用相同的方式，但是那样的局限性很大。所以我们在Joomla 模板能力范围内实行了一种不同的方式，即子模板的使用；我们的做法甚至比Joomla 本身的模板方式更简单，你只需要将下面这个文件夹：Joomla 根路径/component

8、s/com_k2/templates 复制并粘贴至：Joomla 根路径/当前模板路径/html/com_k2/通过第一个路径的形式，我们可以看出K2组件在逻辑上比Joomla 原生的更加清晰易懂。 现在，打开之前复制过来的templates 文件夹，可以看到一些视图(view)文件，例如generic.php 或user.php 等。这些直接位于templates 文件夹中的视图文件是不可以派生出模板变体的；通常，我们通过对default 文件夹中的视图文件进行编辑，来创造模板变体，这些新的模板变体是可以被K2的管理后台识别并提供选择套用的。举个例子来说，在当前K2的模板路径中，即：Joom

9、la 根路径/当前模板路径/html/com_k2/templates复制default 文件夹，重命名为“blog”后粘贴回templates 文件夹，这时在K2的管理后台中，可以发现系统已经将“blog”识别为新的模板变体了；通过这种方式，我们可以为不同类型的内容和页面创建任意多的子模板。要对某个子模板进行自定义，只需要进入相应的模板文件夹并编辑相关的view 文件即可。例如，如果我们对“blog”子模板文件夹中的item.php 进行编辑，那么只有使用“blog”子模板的单篇内容页面会受到影响。新的机制给K2模板编写带来了全新的方法，我们只要使用K2作为基本的内容管理组件，为该组件扩展出

10、一系列子模板，就可以达到在站点全局的不同部分使用不同模板的目的了。例如，我们的站点分为博客、名录和杂志型资讯这三个主要的部分，我们无需使用其他扩展，只基于K2就可以很好的创建它们并赋予不同的子模板。K2官方教程中文版JOOMLA粉丝网（ ）收集整理 当前的开发者和设计师们已经了解到了K2子模板机制的潜力，他们基于这种方式创造了很多令人激动的模板。下面图片中的列表给出了K2组件中模板视图文件的位置以及我们做自定义覆盖时所应将其复制并粘贴的位置： #03 创建菜单链接 在我们使用K2创建了分类及相关内容之后，通常有两种方式将它们呈现出来：一是使用菜单链接指向内容页面，二是使用K2的内容模块来输出；

11、今天我们来第一种方式。进入管理后台，在main menu 中创建新的菜单项；在菜单项类型选择中展开“K2”，可以看到如下图所示的子类型结构： 其中各种类型对应的输出模式可以参考K2安装及设置快速指南一文中第10步的说明。对应着每种类型，在接下来的编辑页面中都会有不同的参数设置；在今后的章节中我们会详细介绍。菜单项创建好之后就会出现在main menu里面了。K2官方教程中文版JOOMLA粉丝网（ ）收集整理 有一个比较典型的需求，就是完全使用K2来打造站点首页，用来替换掉Joomla 默认的输出模式。我们可以在K2中单独创建一个名为frontpage 的内容类别(category)，然后在ma

12、in menu 中创建名为Home 的菜单项，选择Categories 作为菜单项类型，并指向frontpage 类别；然后将Home 设定为默认首页。 #04 使用K2创建Joomla 首页首先来看看目标范例站点，没什么悬念，看上去只是标准的基于默认模板的Joomla 首页。 在本地安装包括范例内容在内的Joomla 测试站点；这步不必多说，安装后前台首页如下图： 接下来我们要对头部的top menu进行无情的篡改，使页面能够在Joomla 默认布局和K2布局之间进行转换。不过在这一步之前，我们还需要把Joomla 的原生内容导入到K2中。导入OK 之后，我们要在K2中建立一个名为”Fron

13、t Page ”的内容分类，用来将所有之前导入的内容归入其下。 接下来进入Joomla 的菜单管理，进入top menu的编辑页面，可以看到默认的4个菜单项：About Joomla 、Features 、News 和The Community 。将后面两个禁用或干脆删除掉，没有所谓，因为我们只需要两个菜单项，一个用于显示默认Joomla 首页，一个用于显示K2形式的首页。进入About Joomla 菜单项的编辑页面，更名为“J!Version ”，将菜单项类型修改为Joomla 原生的Front Page Blog Layout。这样原来的“About Joomla”菜单项就被成功篡改为指

14、向Joomla 默认首页形式的页面了。K2官方教程中文版JOOMLA粉丝网（ ）收集整理下面来搞第二个菜单项；和前面一步类似，进入原来的Features 菜单项编辑页面，更名为“K2 Version”，将菜单项类型修改为K2的Categories ，并绑定我们之前创建的“Front Page”分类。记得保持右边的leading 文章、Intro 文章、列数等参数设置与J!Version 的相同。现在回到菜单项管理页面，如下图所示： 现在，在网站前台页面中，top menu只包括两个菜单项，J!Version 和K2 Version，如下面两张截图所示；由于内容一致，所设置的页面布局参数一致，它

15、们的形式看上去基本一致。如果在之前的菜单项管理页面中，将K2 Version 设置为Default ，那么K2版本的页面就可以直接作为站点首页了。当然在实际站点中通常不需要两个版本的首页，我们所做的J!Version 可以作为练习过程中的备选或对比页面。K2官方教程中文版JOOMLA粉丝网（ ）收集整理 #05 K2首页面板(dashboard)K2的安装过程没有悬念，和常规的Joomla 扩展安装方式相同。安装成功之后，在Joomla 已安装组件列表中点击K2进入就可以进入首页面板了，如下图所示：K2官方教程中文版JOOMLA粉丝网（ ）收集整理顶部菜单栏中的每一个菜单项基本对应着下面默认的

16、功能快捷方式：Dashboard ：返回K2首页面板。 Items ：内容列表；相当于Joomla 的文章列表，但包括所有基于K2创建的各种类型内容。 Categories ：K2只使用category 分类机制，但是可以创建无限级别的下级分类。 Tags ：在K2中，我们可以为内容添加tag 标签；点击这个菜单项就可以查看和管理所有用到的标签。 Comments ：K2内建评论功能，这里可以查看和管理所有的评论。 Users ：查看和管理基于K2机制的用户信息。 User Groups：在这里可以创建或管理用户组别，并对组别设置不同的权限规则。 Extra Fields ：用来为内容添加额外

17、的属性域，类似Drupal 的CCK(Content Construction Kit) 。 Extra Field Groups：为Extra Fields分组；不同的内容类型也是通过这里创建的组别来绑定对应的Extra Fields的。 Information ：查看系统信息，包括已安装的K2的组件和插件信息等。 #06 理解K2工作原理作为一款基于Joomla 的内容创建及管理组件，K2与原生Joomla 最大的区别在于去掉了Section ，取而代之的是多级可嵌套的分类；在概念上，K2中的条目(item)对应着Joomla 原生系统中的文章(article)。下图示意了Joomla 原

18、生机制与K2机制的区别：K2官方教程中文版JOOMLA粉丝网（ ）收集整理使用K2创建内容的逻辑顺序1. 创建分类(Categories)2. 创建额外属性域组(Extra Fields Groups)3. 创建额外属性域(Extra Fields)4. 创建条目(items)5. 创建菜单链接(Menu Link)如果内容方面的需求并不需要额外属性域，可以跳过第2、3步；在创建好额外属性域之后，记得绑定给某个分类，这样该分类下的条目才可以使用这些属性域。 K2官方教程中文版JOOMLA粉丝网（ ）收集整理 #07 创建内容分类通过K2的首页面板(dashboard)或工具栏中的“Catego

19、ries”进入分类页面，这里会列出当前所有创建过的分类条目。我们点击右上方的“New”，进入创建分类页面。首先映入眼帘滴，是Details 表单域： 标题(Title)：用于识别分类的名称。 标题别名(Title Alias)：可以用于显示在URL 中替代分类标题；对于英文可以留空，系统默认使用标题作为别名。 父级分类(Parent Category)：如果要创建的分类是某个已存在分类中的子分类，那么可以在这里选择其父级。 继承参数(Inherit Parameters)：如果要创建的分类是某个已存在分类中的子分类，那么可以在这里选择是否继承其父级分类的参数设置；很有用的一个功能。 绑定额外属

20、性域组(Associated Extra Field Groups)：为当前分类绑定已创建过的额外属性域组，这样该组中的所有属性域都可以在新分类的内容中使用了。 发布(Published)：分类创建后是否发布。 访问权限等级(Access level)：设定该分类对哪些组别的用户可见。通过这些基本步骤，我们就可以创建出在K2中使用的内容分类了；回到分类列表页面，新的分类条目应该已然出现了：有关右侧参数设置的详情，我们将在对应的章节中仔细围观。 K2官方教程中文版JOOMLA粉丝网（ ）收集整理 #08 创建额外属性域首先来看怎样创建分组(Extra Field Groups)，很简单，通过K2

21、的首页面板(dashboard)或工具栏中的“Extra Field Groups”进入列表页面，点击右上方的“New”即可创建新的分组，如下图所示：没悬念，起个名字就OK了；因为分组是要与内容分类绑定的，所以在命名上可以与分类的名称对应。根据需求创建不同的分组之后，就可以在Extra Field Groups看到它们了。 Group 只是贴了名称标签的容器，额外属性域(Extra Field) 才是正货。虽然比起Drupal 的CCK ，K2提供的额外属性域的局限性还是比较大的，但是在需求不是很复杂的情况下，还是比较简单易用的。进入Extra Field页面，点击右上方的“New”，即可进入

22、Extra Field的创建页面，如下图所示：名称(Name)：属性域的名称。 发布状态(Published)：设置该属性域是否可视。 组别(Group)：选择之前创建的属性域分组，或直接创建新的分组。K2官方教程中文版JOOMLA粉丝网（ ）收集整理 类型(Type)：比较关键的地方，为属性域选择类型，例如文本、链接、表单元素一类。 默认值(Default Value)：属性域的默认值。同样，创建之后，在Extra Fields页面中就会看到已创建属性域的列表了。#09 创建内容条目首先通过K2的首页面板(dashboard)或工具栏中的“Items”进入内容条目列表页面，点击右上角的“Ne

23、w”进入内容条目的创建页面(也可以在首页面板中直接点击“Add new item”)，如下图所示：标题(title)：内容条目的标题。 标题别名(title alias)：内容条目标题的别名，用于SEF URL中。 标签(tags)：内容条目的标签；新版本(2.2)的K2中为我们提供了两种输入tag 的方式，自由输入和多选。 发布状态(published)：设置内容条目在创建后的发布状态。 特色条目状态(featured)：设置内容条目是否作为“特色内容”显示。 分类(category)：该内容条目所属的内容分类。根据自己的需求做相应设置，搞定内容条目的基本信息，是时候去进一步创建内容了！无谓

24、的激动了一记。K2官方教程中文版JOOMLA粉丝网（ ）收集整理 在这里，我们可以为内容条目创建正文内容、图片集、相关视频，还可以附上相关文件作为附件供用户下载；当然，如果当前内容条目所属的分类绑定了某个Extra Field 组，我们就可以在这里为相关的field 设定内容了。侧边栏是可以通过“toggle sidebar”展开或关闭的，在这里我们可以为当前内容条目做更加详细的参数设置；相关话题会在后面的章节中展开详说。 内容条目的基本创建方式是很简单的，提交或保存后就可以在Items 页面中看到新创建的条目了。#10 分类参数详解 - 内容布局内容分类的参数设置话题分两部分：内容条目布局设

25、置和分类页面呈现方式设置；今天来看第一个。通过K2的首页面板(dashboard)或工具栏中的“Categories”进入分类页面，这里会列出当前所有创建过的分类条目；点击某分类名称进入编辑设置页面，展开右侧的Category item layout：K2官方教程中文版JOOMLA粉丝网（ ）收集整理这个选项卡中的参数用来设置该分类下内容条目的单篇呈现方式；对应着截图，我们依次看下每个参数：1. 选择模板(Select a Template)：如果我们创建或下载并部署了适用于K2的模板，那么可以在这里为所有该分类下的内容条目选择使用某个模板。2. 头条内容数量(#Leading)：和Jooml

26、a 自带的头条文章数量参数相同，用来设置作为头条显示的内容条目数量。3. 头条内容的列数(Columns for leading)：设置头条内容的列数。K2官方教程中文版JOOMLA粉丝网（ ）收集整理 4. 头条内容图片尺寸(Image size for leading items)：为头条内容的图片选择预设的尺寸名称，比如Small 等；可以在K2的全局参数设置中为每个规格设定具体的尺寸。5. 主要内容数量(#Primary)：用来设置主要内容的数量。6. 主要内容的列数(Columns for primary)：设置主要内容的列数。7. 主要内容图片尺寸(Image size for p

27、rimary) ：为主要内容的图片选择预设的尺寸名称。8. 次级内容数量(#Secondary)：用来设置次级内容的数量。9. 次级内容的列数(Columns for secondary)：设置次级内容的列数。10. 次级内容图片尺寸(Image size for secondary)：为次级内容的图片选择预设的尺寸名称。11. 作为链接显示的内容数量(#Links)：设置那些只显示标题作为链接的内容条目的数量。12. 链接内容的列数(Columns for links)：设置链接内容的列数。13. 链接内容图片尺寸(Image size for links)：为链接内容的图片选择预设的尺寸名

28、称。14. 目录模式(Catalog mode)：如果选中，那么只有该分类下的直接内容条目会显示，其子分类中的内容条目将不会显示。15. 特色内容(Featured Items)：如果指定了某些内容条目为“特色内容”，那么可以在这里控制他们是否显示出来。16. 内容条目排序(Item Ordering)：控制该分类下内容条目的排序规则。17. 页脚导航(Pagination)：当单页中的内容条目数量超过指定数量时页脚导航的显示规则。18. 页脚导航结果(Pagination Results)：是否在页脚导航中显示当前页码。 #11 分类参数详解 - 分类页面设置通过K2的首页面板(dashbo

29、ard)或工具栏中的“Categories”进入分类页面，这里会列出当前所有创建过的分类条目；点击某分类名称进入编辑设置页面，展开右侧的Category view options ：K2官方教程中文版JOOMLA粉丝网（ ）收集整理我们可以看到，Category view options中的参数一部分用于设置当前主类别，另外一部分用来设置其下级分类(Sub-category)的呈现方式。首先来看主分类的5个参数：1. 标题(Title)：用来设置是否在分类页面显示当前分类的标题。2. 内容条目数量(Item Counter)：用来设置当分类标题显示时，是否同时显示其中内容条目的数量。3. 描述

30、(Description)：用来设置是否显示分类描述。4. 图片(Image)：如果有上传过用于标识当前分类的图片，那么在这里设置是否将其显示出来。5. RSS 链接(RSS Feed Link)：用于设置是否显示对应于当前分类内容的RSS 链接。 接下来看看下级分类的7个参数：1. 下级分类区块(Sub-category blocks)：设置是否显示下级分类区块。2. 列数(Columns)：设置下级分类区块将分作几列显示。K2官方教程中文版JOOMLA粉丝网（ ）收集整理 3. 下级分类顺序(Sub-category ordering)：设置下级分类区块的排序规则。4. 下级分类标题(Sub-category title)：设置是否在下级分类区块中显示其标题。5. 内容条目数量(Item Counter)：用来设置当下级分类标题显示时，是否同时显示其中内容条目的数量。6. 下级分类描述(Sub-category descri