Drupal宝典之基础篇(zz)

= Drupal 的模块 = 模块化是drupal的一个特色，极大的方便了drupal的扩展和灵活定制的能力。Drupal模块的安装使用也很方便，只要将相应文件复制到modules目录下，就可以在‘管理-设置’里面方便地开启使用了。 Drupal的模块分为基本功能模块和功能增强模块。基本功能模块是Drupal安装包里自带的功能模块，扩展功能模块则需要到 [http://drupal.org/project/Modules] 下载。基本功能模块又分为固定启用的基本功能模块和可选用的基本功能模块，固定启用的模块在drupal安装后即自动启用。 == 固定启用的模块 == - block 用于支持区块的实现 - filter 用于处理内容过滤以便于显示。 - system 用于处理管理员对站点的设置。 - user 用户管理及注册系统。 - watchdog 生成并管理系统日志。 == 基本功能模块 == - aggregator: 将drupal变成一个在线的rss订阅器。支持RSS和RDF格式。开启后可定时扫描新闻源自动更新内容（需要crontab支持）。 - archive 支持存档内容的管理与浏览，实现blog常见的日历查询功能，可通过区块显示。 - blog 这个模块让会员发表个人blog，使Drupal变成一个多人blog系统。 - blogapi 支持XML-RPC blog接口，允许用户通过第三方应用程序发表blog。 - book 允许多位会员一起合写一本书。 - comment 开启blog或文章的评论回复功能，并且可以定制评论的权限以及每一篇文章是否允许评论。 - contact 允许注册用户间通过填写‘联络表’发email联系。 - drupal 让用户使用一个 Drupal ID 跨站登录。 - forum 论坛 - help 在线帮助。很多标准模块和功能的帮助都可以在‘管理-帮助’里找到。 - legacy 为升级版本提供向下兼容的接口。 - locale 开启多语言支持，汉化drupal必须开启的模块。 - menu 允许管理员定制，添加新的导航菜单。 - node 所有blog或文章都必须通过node模块来提交和呈现给读者。 - page 用于发布静态页面。 - path 支持URL别名，便于管理记忆。 - ping 在发表新文章的时候通知其他网站。 - poll 开启投票功能。 - profile 开启此模块后，管理员将可以自定义用户注册时的表单项目和格式。 - queue 允许管理员监管文章，所有新提交的文章将先进入监管队列，经过监管员(moderator)考察后决定是否发表。 - search 该模块支持站内搜索。能够很好的支持中文搜索，而且速度很快。 - statistics 记录访问统计信息。 - story 不想把这类文章包括在你的日志里时，就可以通过这个模块实现。 - taxonomy 开启目录分类支持 - throttle 站点节流控制机制。当站点流量过大网络阻塞时可以通过节流设定自动关闭相应模块功能以保证访问响应。 - tracker 跟踪用户的最新发布。 - upload 支持上传文件。 == 功能增强模块 == Drupal的功能增强模块太多了，并且每天都在不断增加，这里只列出其中一些主要的功能增强模块： - acidfree 一个功能完整的多媒体(例如图片、视频)管理系统。 - adsense 显示Google Adsense广告。可以方便的定制显示方式，支持从banner到link等6种显示格式。此外还可以选则对特定用户群关闭广告显示。 - album 影集模块。 - audio 登录用户可以上传、播放和下载音乐。能很好地识别mp3的ID3信息(例如歌名、艺术家等) - atom 提供atom种子 - attachement 支持上传附件，可以用来替代Drupal自带的upload模块。不同节点的附件将分开放置，避免了文件重名的问题。 - automember 自动用户权限管理。管理员可以设定不同的标准，自动分配给用户不同的权限。例如只开放有限权限给新注册用户，发表一定数目文章后将自动成为资深用户并得到高级权限 - banner 自动轮换显示广告条。管理员可以方便的查看点击统计，并预设/开启/关闭/批准特定广告，用户则可以查看/修改/上载自己的广告条。 - bbcode 提供bbcode输入格式的支持。 - blog theme 允许用户选择自己blog的外观主题，当其它用户按作者浏览其blog时，看到的将是该blog作者自己选定的外观主题。 - bookmarks 用户可以编辑自己的书签，并通过区块显示。 - buddylist 用户可以编辑自己的好友名单，同时显示‘好友的blog’区块。 - captcha 图灵测试/字符校验模块，防止机器人自动注册 - chatbox 聊天室模块。 - codefilter 方便代码输入，能处理<code></code>和<?php ?>。 - contact directory 使用户可以添加自己的好友联络名单。 - database administration 提供数据库管理功能。管理员可以通过此模块在drupal界面进行数据库查询/修改/删除等功能。 - devel 为开发者和网管提供了许多好的工具。 - e-commerce 一整套电子商务工具。 - event 跟踪事件并通知用户。 - excerpt 摘要模块。Drupal发布内容时只能用正文的开头作摘要，然后根据设定自动截取摘要。 - ezmlm 用户将可以通过该模块订阅相关Ezmlm邮件列表。Ezmlm是一个基于qmail的群发邮件订阅系统。 - feedbak 反馈模块，可用于生成反馈表格收集用户意见或问题。 - flexiblock 让Drupal能随心所欲的摆放区块。 - flexinode 可以用此模块根据需要生成新的自定义节点(node)类型。在此基础上可以有很多灵活多变而非常实际的应用，可以说是drupal扩展模块里功能非常重要的一个。 - front page 用于方便的定制站点首页，可以完全脱离站点外观主题的限制生成个性化的首页。可以显示不同的首页给不同权限的用户，并可插入PHP代码完成更强大的动态显示。 - gallery 用于在线像册管理和展示。 - guestbook 留言簿 - hall of fame 名人堂模块&#22359;&#65533;&#65533;&#65533;是对drupal自带的统计(statistic)模块的补充，可以统计站点共几篇文章，多少注册用户，建站时间，流行内容等，还可以显示发文最多用户，评论最多用户等。 - htmlarea 一种所见即所得的输入方式。 - image 像册。支持图片上传，并自动生成缩略图(thumbnail)。图片可以插入到页面中或组合成像册显示。 - img_assist 和Image模块共同使用，通过图形界面窗口更便捷地在节点中插入图片。 - internationalization 自动检测浏览器的编码设定，为匿名用户提供全方位的本地话翻译，包括节点内容界面的翻译。包括一个显示区块方便用户切换语种。 - job search 招聘与求职模块 - jsdomenu 生成多层弹出式菜单 - mail 向特定用户群发送email - mailhandler 允许注册用户通过email创建/编辑内容或添加评论。 - media 这个模块将已废弃，分别被audio和video等模块取代。 - movie review 网上电影院 - node vote 对文章进行投票 - notification 自动发送邮件通知订阅者内容已更新。 - organic groups 允许用户自行组成小组，每个小组将有自己的主页显示小组成员发布的内容。 - pdfview 生成PDF文件 - photo album 像册模块。 - privatemsg 允许用户间发送私人信息。 - project 项目管理模块。项目组成员可以由此跟踪项目的进展，可以通过email发送项目更新通知。 - quote 用户在添加评论时可以方便的点选引用原文。引用部分用特殊格式显示以作区分。 - quotes 可以用于收集显示名人名言。通过区块随机显示。 - recipe 用于分享菜谱。 - rsvp 可以发送email邀请用户参加特定的事件(event)，并可跟踪用户是否查看或接受了邀请。 - site map 显示站点导航图。 - sitemenu 按文章分类显示站点导航。 - smiley 使用表情符，自带了一些基本的表情符，用户可以自己添加。 - SMS gateway 发短信 - spam 防垃圾模块，防止你的blog成为一个实实在在的垃圾堆。 - spam_surbl 对spam模块进行功能增强，使之支持SURBL(Spam URI Realtime BlockList)。 - sql search 此搜索模块不使用drupal自带的搜索索引(search index)，而是提供数据库搜寻功能，支持SQL和正则表示式(regular expressions)，并提供高级搜寻过滤功能。 - statistics_filter 过滤网站管理员和搜索引擎的访问统计信息。 - stock 显示股票行情。用户可以自定制所显示的股票。 - subscriptions 允许用户订阅任一节点内容，通过email通知该节点的更新以及是否有新的评论。 - survey 可以创建调查问卷，调查结果可以下载为excel格式。 - taxonomy menu 分类系统导航菜单，其格式将和drupal系统导航菜单一致。 - theme editor 直接通过浏览编辑修改外观主题。 - tinyMCE WYSIWYG Editor 一个非常好用的所见即所得文本编辑器，用于编辑输入文章内容。 - trackback 开启trackback支持。 - video 在线影院 - VIM Color 支持VIM代码高亮(highlight)，支持PHP, Perl, C, HTML, JAVA等多种语言。 - voting 投票/评级 - webform 创建‘网络表单’节点类型，可以用于提交调查问卷，投票，注册等。 - wiki 实现wiki功能。 - workspace 我的工作空间模块，提供一个用户专有的工作区，可以集中察看管理自己的文章。

http://www.linuxsir.org/bbs/showthread.php?t=231113 Drupal宝典之定制篇 在开始Drupal的定制前，需要&#35201;&#65533;&#65533;&#65533;了解一些Drupal的基础知识。Drupal宝典之基础篇见： http://www.linuxsir.org/bbs/showthread.php?t=230650 在对Drupal做定制前，需要了解一些Drupal的基本术语： + Block(区块) 区块一般位于网页两边的侧栏中，用于导航或显示一些附加内容。区块是一种&#31181;&#65533;&#65533;&#65533;数据定位到页面的方法之一。各主题风格可以通过block($subject, $content, $region = "main")函数来控制区块的显示风格。 + Box(盒子) 盒子是Drupal页面内容的容器。每一个盒子有一个标题和一些内容。各主题风格可以通过box($subject, $content, $region = "main")函数来控制盒子的显示风格。 + Engine(引擎) 引擎是一类特殊的主题，它通过模板来输出HTML内容。 + Filter(过滤器) 过滤器是做内容过滤的框架。 + Module(模块) 模块是为Drupal提供扩展功能的代码片段。有些模块是Drupal核心系统的一部分(例如taxonomy和blog模块),扩展模块(例如 weblinks和image模块)则不属于Drupal的核心系统。核心模块已包含在Drupal的下载包中，扩展模块则需要单独下载。 + Node(节点) 节点是Drupal中最简单又最难理解的一个概念。几乎Drupal中所有的内容都被存储为一个节点。一个节点就是Drupal的一块内容，它可以是投票、报道、书的一页、或一张图片。 + Permissions(权限) 权限用于控制内容的创建、修改和站点管理等访问。管理员可以将权限赋给角色，将角色赋给用户。一个用户可以属于一个或多个角色。Drupal缺省提供了两种角色：游客和注册用户 + Style(样式) 样式是主题或引擎提供的CSS文件，用于替换缺省的CSS。 + Taxonomy(分类) Drupal通过分类来描述目录系统，用于对网站的内容进行组织和分类。 + Template(模板) 模板是基于某一模板引擎的，普通人可读懂的HTML文件，这些文件有一些特殊的代码，用于产生动态信息。 + Theme(主题) 主题是包含一些函数的PHP文件，用于提供不同的布局风格 = Drupal 模块安装 = Drupal 已经自带了许多基本功能模块，在完成 Drupal 的安装后，开启这些模块就可以了。 如果你需要功能扩展模块，则需要到 http://drupal.org/project/Modules 下载并安装这些模块。 步骤非常简单： + 下载模块包 + 解压缩 + 把模块文件上传到 Drupal 的 modules 目录中 + 有些模块可能需要运行 mysql 文件创建表 + 在“管理->模块"中开启这个模块 = Drupal的邮件发送设置 = 用户在网站进行注册时，口令将发送到用户的邮箱里。这需要你的网站能进行邮件发送。 网站发送邮件的办法有许多种，这里推荐一种使用ssmtp发送邮件的方法。 假设你有一个gmail帐户，并打算用该帐户发送邮件： + 设置ssmtp # vi /etc/ssmtp/ssmtp.conf 对该文件做如下设置： root=xxxx@gmail.com (注：xxxx为用户名) mailhub=smtp.gmail.com:465 rewriteDomail=gmail.com hostname=gmail.com + 设置php.ini # vi /etc/php/apache2-php4/php.ini 对该文件做如下设置： sendmail_path = /usr/sbin/ssmtp -t -auxxxx@gmail.com -apxxxx (注：前一个xxxx是用户名，后一个xxxx是口令) + 在Drupal的"管理->设置->通用设置->E-mail地址"中 将E-mail地址设置为xxxx@gmail.com。 = forum：论坛 = Drupal的forum模块提供论坛功能。 在使用论坛模块时，应同时开启comment模块和taxonomy模块。comment模块为Drupal的节点提供讨论板功能，对论坛主题的回复就要用到该功能。taxonomy是智能分类模块，用于组织网站的内容，能自动对内容进行归类。 comment和taxonomy是论坛正常运行所必需的两个模块。 还可以配合其它模块来增强论坛的功能： + "管理->用户->配置"可以开启头像(图片)功能 + 通过开启profile模块增强用户个人信息，可在"管理->设置->个人信息"中增加自定义内容 + 通过使用privatemsg模块，用户间可以互相发短消息 privatemsg是一个站内消息系统，可在这里下载： http://drupal.org/project/privatemsg privatemsg的中文包在这里下载： http://drupal.org/files/issues/priva...s-4.6.0.tar.gz + 通过subscriptions模块或notify模块让用户接收E-mail通知 + 通过bbcode模块提供BBCode支持。 bbcode模块将提供一个工具条，能很方便地在帖子中插入bbcode

= 定制自己的首页 = 在"管理->设置->通用设置->默认首页"里可以设置自己的首页，默认值是"node"。它仅仅显示一些被设置为“推荐到首页”的文章。 + 假设你创建了一个新的节点，包含有非常多的链接和非常复杂的内容，想把这个节点设置为首页。首先找到这个节点的id，假设节点id是83，你只需要将默认首页设置为"node/83"就行了。 + 假设你想将用户blog设置为首页，则须将默认首页设置为"blog"。 + 假设你想把论坛设置为首页，则须将默认首页设置为"forum"。 = Drupal 界面定制 = 当 Drupal 站点安装好后，有许多方法对站点界面进行个性化的设置和定制： + 安装主题风格 主题风格控制了站点的外观和感受，你可以在网上下载Drupal的主题风格，并在"管理->主题"中启用这些风格。 + 创建你自己的主题风格 如果你不想用别人预先做好的主题风格，而想为自己的站点打造一个完全不一样的外观，你可以通过开发自己的主题风格来达到这个目的。主题风格的开发人员应具备HTML/CSS知识，如果要开发复杂的主题，则需要懂得PHP。 + 定制导航菜单 页面顶部和底部的菜单可以在"管理->主题->配置->菜单设置"中进行定制，主链接和备用链接中可以直接编写HTML代码。如果主链接为空，Drupal将根据你安装的模块自动建立导航菜单。每个主题风格可以定义不同的导航菜单。 如果是基于PHPTemplate引擎的主题风格，导航菜单的定义方式是为每个菜单进行定义。 + 定制文字串 可以通过"管理->本地化->管理字符串"来定制本地语言的文本字符串，Drupal中几乎所有的文本字符串都可以修改。 = Drupal 的主题风格 = == 模板引擎 == Drupal支持三种模板引擎：xTemplate、PHPTemplate、wgSmarty。xTemplate是Drupal自带的模板引擎，但支持该引擎的主题风格数量不多。其他两个模板引擎需要到 http://drupal.org/project/Theme%20engines 下载。其中基于 PHPTemplate 的主题风格非常多。 推荐使用 PHPTemplage，这个引擎大大加快Drupal的速度，非常有利于自己自定义模板，一些大型的Drupal站点都是用的这个引擎。 PHPTemplage 的安装方法： + 下载 PHPTemplate + 将解压后的phptemplate目录拷贝到Drupal的themes/engines目录 == 主题风格 == “主题”是Drupal站点的基本外貌和感觉。有时一个特定的站点会安装不止一个的主题。如果站点管理员提供了多个主题，你可以为你的帐号选择你喜欢的默认主题。 Drupal的官方站点提供了许多主题风格，具体见： http://drupal.org/project/Themes 其中，Spreadfirefox是我最喜欢的主题风格，著名的 spreadfirefox.com 使用的就是这款主题。 除Drupal的官方站点外，还有许多其他机构或个人提供Drupal的主题风格，通过Google可以搜索到这些风格。 == Drupal 主题风格安装 == Drupal 主题风格的安装非常简单： + 在 http://drupal.org/project/Themes 下载新的主题风格 + 阅读主题风格包中的 README 和 INSTALL 文件，看该主题风格包的安装是否需要一些特殊的步骤 + 检查一下主题风格需要的模板引擎是否已安装 + 将主题风格上载到Drupal的themes目录中 + 通过"管理->主题"启用该主题风格，并将其设置为默认风格 == 主题风格中CSS的定制 == Drupal的主题定制非常灵活，可以定制每个区块定制的风格。如果懂PHP的话，几乎可以做出可以想得到风格来。 实际上，在大多时候我们主要是通过图片+CSS来定制，这是一种最简单的定制，也不需要懂得太多的PHP知识。 在themes目录下的每个主题目录中，有一个style.css文件。定制CSS的关键是搞清楚CSS元素控制的对象。但许多人搞不清楚CSS元素控制的对象，在这方面花了不少时间。其实只要选对工具，这实际上是非常容易做的。 这个强大的工具就是Firefox。大多数人只知道Firefox是一个浏览器，实际上Firefox提供了大量网页开发的工具。例如： + 选定一部分网页内容，通过右键菜单的View Selection Source功能，可以查看选定部分网页的源码。这是一个杀手级的功能，再也不必为在庞大的HTML源码中找不到相应的目标内容而头痛了。 + 菜单 Tools->Page Info 可以看到非常详细的网页内容，包括表单、链接、多媒体等信息 + 菜单 Tools->DOM Inspector 可以对网页的HTML、JavaScript、CSS等内容进行很方便的分级浏览 Firefox的功能太多，一时半刻说不完，我们还是回到CSS定制上面来。这需要用到一个Firefox的插件，插件名称是Web Developer，可以在Firefox的网站上下载到这个插件。 安装好Web Developer插件后，就可以用其提供的功能来定位对象的CSS控制元素： + 插件的CSS菜单下有一个View Style Information功能非常好用，当你的鼠标电击到网页的某项内容，就能看到该项内容所使用的相关CSS内容。 + 在Information菜单下有一个Display ID & Class Details功能，能在网页上显示所有的ID和Class信息。 Web Developer插件是专门为网页开发人员提供的一把宝刀，功能太丰富了，你们就慢慢去体会吧。

= 提供搜索引擎友好的URL地址 = Drupal提供了一个path模块，该模块能定义URL地址的别名。这些别名能大大提高地址的可读性，能帮助搜索引擎更有效地对站内内容进行索引。每个页面可以创建多个别名。 例如(左边是URL地址，右边是为其创建的别名)： user/login => login image/tid/16 => store taxonomy/term/7+19+20+21 => store/products/whirlygigs node/3 => contact node/10 => products/merchandise/cups node/10 => cups node/11 => products/merchandise/coffeemakers == 批量别名设置 == Drupal里允许批量为URL设置别名。通过这个功能，可以提供完全不一样的URL地址，甚至可以为不同的语言提供完全本地化的地址。 批量修改别名的方法是在sites/default/settings.php中添加一个conf_url_rewrite函数(4.6.x)，如果是Drupal 4.7.x，则函数名是custom_url_rewrite。 以下例子将所有的"node/$node_id"类型的URL修改为"display/$node_id"： <?php // 用于 Drupal 4.6.x 的例子 function conf_url_rewrite($path, $mode = 'incoming') { if ($mode == 'incoming') { // 从客户端来的URL return preg_replace('!^display/(\d+)$!', 'node/\1', $path); } elseif ($mode == 'outgoing') { // 到客户端去的URL return preg_replace('!^node/(\d+)$!', 'display/\1', $path); } } ?> <?php // 用于 Drupal 4.7.x 及更高版本的例子： function custom_url_rewrite($type, $path, $original) { // 如果已经为该地址设置了别名，则不作进一步处理 if ($path != $original) { return $path; } if ($type == 'source') { // 从客户端来的URL return preg_replace('!^display/(\d+)$!', 'node/\1', $path); } elseif ($type == 'alias') { // 到客户端去的URL return preg_replace('!^node/(\d+)$!', 'display/\1', $path); } } ?>