跳转到主要内容
haihaifeng 提交于 28 February 2012

原文地址:http://drupal.org/project/examples

示例(面向开发者)

本项目旨在为Drupal的核心功能的广泛性提供高质量,注释良好的API实例。

通过练习实例,开发者可以快速的学习到怎么使用特定的API,并把他们变为己用。

新闻

  • 2011年11月19日:Cron实例添加
  • 2011年9月5日:主题实例添加
  • 2011年8月17日:页面实例
  • 2010年12月13日:action实例增加到D7实例模块中
  • 2010年10月14日:一个多扩展表单实例增加到D7表单实例模块中
  • 2010年10月14日:新增了一个Drupal 6的Token实例
  • 2010年10月2日:XMLRPC实例的大部分返工以及改善。
  • 2010年9月26日:增加一个渲染实例以说明D7渲染子系统是怎么工作的
  • 2010年5月9日:元素实例完善(新实例),移动到表单实例中,并增加了测试
  • 2010年8月11日:新文件实例(D7)表现文件API,以及流封装的实施
  • 2010年7月28日:改善了页面实例来表现渲染数组的返回值
  • 2010年7月28日:重做补丁实例
  • 2010年7月28日:在表单实例模块#state实例中增加了深度
  • 2010年7月20日:增加AHAH验证实例到Drupal 6 AHAH实例中

实例模块状态:

 

你能为我们做些什么?我很高兴你问这个问题:

  • 首先,我们需要你记录问题每当你发现那些错误的,模糊不清的以及可以表现的更好的地方。
  • 我们需要更多的实例。
  • 我们需要对存在的实例模块进行检查,更正,改善。
  • 我们需要改善doxygen文档中注释。
  • 我们需要帮忙找出怎样更好的组织大量的实例,以及怎样改善doxygen在api.drupal.org上面的输出。
  • 请随时帮助解答问题队列中的问题。

另外待写实例清单:

  • 实体实例
  • 核心域组件实例
  • 缓冲实例
  • 模块主题实例
  • 用户API实例
  • 安全考虑实例
  • 更新/升级系统实例
  • 表单覆写实例(D7)

我们仍然需要测试大量的实例,尤其是D6,你可以检查问题队列来获知我们的进展。

作为一个开发者你需要什么样的实例呢?在问题队列中建立一个问题如果你认为有必要的话。

补丁和新实例模块的提交指南

欢迎有新的实例模块被提交出来,如果你乐意去维护它,你可以问我们要维护者权限。

无论你是否具有提交的权限,所有的改变应该首先作为一个补丁来提交。我们现在的模块都已经通过了机器测试,所以为了不破坏原来的模块,新模块首先作为补丁提交,然后保证它通过测试,是很重要的。

  •   在最终提交之前先作为一个补丁提交,保证你的测试实例全部通过。
  •   你提交的新实例模块必须要验证一块核心功能。
  •   要遵守Drupal 编程风格。在你提交你的模块之前请先运行一下Coder模块。
  •   每一个实例模块都必须有至少一个引导向实例模块验证功能页面的菜单链接。菜单链接应该是‘examples/该实例模块需要验证的功能’。
  •   一般来说,不要为你模块的使用限定什么权限。
  •   请谨记,你的实例应该非常的简单。它唯一的作用是教开发者理解这个核心功能,而不是炫耀你的能力。顺便帮助开发者理解一下概念性的东西。
  •   提供hook_help()返回给用户一些帮助提示。
  •   提供适当的外部文档(包括手册页,外部网页等等)链接让大家可以找到更多获得帮助的地方。
  •   api.drupal.org 将会展示这些代码给所有的搜索者,所以请你确保你的代码中有phpDoc可以识别的高质量的注释。
  •   我们的愿景是期望每一个核心模块都有对应的实例模块。这些实例模块不只是为了验证这些核心模块的功能,它自身对于开发者也应该是一项巨大的资源。

我们需要为大量的实例模块寻找特定的维护者,就像核心模块那样,所以如果你想要“掌管”一个实例模块的话,请在问题队列里报名。

荣誉榜

 

Taxonomy upgrade extras