Gallery: 代码概览：修订间差异

来自站长百科
跳转至： 导航、​ 搜索
无编辑摘要
无编辑摘要
 
第9行： 第9行：
== 视图 ==
== 视图 ==


模块在模块目录的<tt>*.inc</tt>文件中对视图（类别扩展<tt>[http://gallery.menalto.com/apidoc/GalleryCore/Classes/GalleryView.html Gallery视图]</tt>）进行定义。有两类视图：
模块在模块目录的<tt>*.inc</tt>文件中对视图（扩展类别<tt>[http://gallery.menalto.com/apidoc/GalleryCore/Classes/GalleryView.html Gallery视图]</tt>）进行定义。有两类视图：


'''标准视图（Standard Views）'''：
'''标准视图（Standard Views）'''：
第22行： 第22行：
== 外观主题 ==
== 外观主题 ==


Themes have total control of Gallery's page layout and appearance.  The Gallery framework determines the type of page being accessed and calls one of six functions in the active theme's <tt>theme.inc</tt> file (a class extending <tt>[http://gallery.menalto.com/apidoc/GalleryCore/Classes/GalleryTheme.html GalleryTheme]</tt>).
外观主题对Gallery页面布局和外观具有完全的控制。Gallery框架决定访问页面的类型并在活动外观主题的<tt>theme.inc</tt>文件中呼叫六种函数之一。（扩展类别<tt>[http://gallery.menalto.com/apidoc/GalleryCore/Classes/GalleryTheme.html Gallery外观主题]</tt>）。


* <tt>showAlbumPage</tt> or <tt>showPhotoPage</tt>: Displays individual or grouped Gallery items
* <tt>showAlbumPage</tt>或<tt>showPhotoPage</tt>：显示单个或组合的Gallery项目
* <tt>showModulePage</tt>: Other Gallery pages added by modules
* <tt>showModulePage</tt>：由模块添加的其他Gallery页面
* <tt>showAdminPage</tt>: Gallery administration pages; they function just like module pages, but call a different theme function in case the theme wants to customize the display of browsing vs admin pages
* <tt>showAdminPage</tt>：Gallery管理页面；它们如模块页面般运行，但如果外观主题要自定义浏览器管理页面的显示的话，就会呼叫外观主题函数
* <tt>showErrorPage</tt>: <tt>main.php</tt> routes errors to the <tt>core.ErrorPage</tt> view
* <tt>showErrorPage</tt>：<tt>main.php</tt>将错误引导至<tt>core.ErrorPage</tt>视图
* <tt>showProgressBar</tt>: Controllers may delegate control to the <tt>[[Gallery2:Progressbar|core.ProgressBar]]</tt> view for long running tasks
* <tt>showProgressBar</tt>：控制器会将控制委任给<tt>[[Gallery:Progressbar|core.ProgressBar]]</tt>视图以运行任务


Each of these functions loads any additional required data into the template and then specifies a <tt>tpl</tt> file for the page display.  In most cases this is <tt>theme.tpl</tt>. Calling theme.tpl first creates a wrapper for other page types and maintains a basic look and feel (headers, banners, etc) across all Gallery pages.  The <tt>theme.tpl</tt> then rechecks the page type and includes the associated <tt>tpl</tt> for the Gallery content requested.  [[Gallery2:Themes|More about themes and the template system]]
各函数将额外所需的数据载入到模板中，然后为页面显示指定一个<tt>tpl</tt>文件。在大多数情况下，此为<tt>theme.tpl</tt>。首先呼叫theme.tpl文件会创建其他页面类型的wrappera，并在所有Gallery页面中保持一致的基本外观（头，横幅等）。<tt>theme.tpl</tt>接着会重检页面类型，并针对被请求的Gallery内容包括进相关的<tt>tpl</tt>。[[Gallery:Themes|有关外观主题和模板系统的详细信息]]


== 控制器 ==
== 控制器 ==


Controllers perform actions that will save changes on the server.  Adding new photos or comments, changing settings or even logging in are actions handled by controllers.  Controllers extend the <tt>[http://gallery.menalto.com/apidoc/GalleryCore/Classes/GalleryController.html GalleryController]</tt> class and their code resides in the <tt>*.inc</tt> files in a module's directory along with the views.
控制器执行动作将更改保存到服务器上。添加新相片或评论，修改设定，甚至是登入，这些都是由控制器进行处理的。控制器扩展了<tt>[http://gallery.menalto.com/apidoc/GalleryCore/Classes/GalleryController.html GalleryController]</tt>类别，而它们的代码则位于模块目录及视图的<tt>*.inc</tt>文件中。


Generally the first task done by controllers is to verify proper [http://gallery.menalto.com/apidoc/GalleryCore/Classes/GalleryCoreApi.html#methodassertHasItemPermission permissions] for the requested action.  Always remember that even if your view omits a button or link based on permissions, the controller still must check permissions as HTTP requests can be manually constructed.
一般说来，控制器首要任务就是针对被请求的动作，进行[http://gallery.menalto.com/apidoc/GalleryCore/Classes/GalleryCoreApi.html#methodassertHasItemPermission 权限]确认。切记就算你的视图缺失了某些基于权限的按钮或链接，控制器还是必须检查权限，因为HTTP请求可以手动建立。


The second task is to validate the input data.  If any user entered data is missing or invalid, the controller adds a token to the <tt>$error</tt> array that will be returned.  Only if the inputs are valid does the controller proceed with the operation and set a key in the <tt>$success</tt> array.  Controllers then instruct <tt>main.php</tt> what to do next.  Upon success a controller will send a <tt>redirect</tt>, usually back to the same view.  The <tt>$success</tt> data is stored in the session and made available to the view in the next request so it can show a status message.  If <tt>$error</tt> is nonempty usually a controller will <tt>delegate</tt> back to the same view.  This means the view is rendered in the same HTTP request, so the given <tt>$form</tt> data is still available.  The view can then fill in the user entered data (so they don't have to enter it again) and check the <tt>$error</tt> tokens to show the appropriate error message next to the invalid data.  These checks and messages are in the <tt>tpl</tt> file for the view.
第二个任务就是认证输入数据。如果某用户输入的数据丢失或无效，控制器就标记将要返回的<tt>$error</tt>数组。仅当输入有效时，控制器才会继续操作并在<tt>$success</tt> 数组中设置一个key。接着，控制器就会指导<tt>main.php</tt>的后续操作。成功时，控制器通常就会向相同的视图发送一个<tt>redirect</tt>。<tt>$success</tt>数据被保存在会话中，并在接下来的请求中可用于视图，因此它可以显示一个状态消息。如果<tt>$error</tt>非空，通常控制器就会<tt>委任给</tt>相同的视图。这就意味着视图在相同的HTTP请求中被渲染，因此给定的<tt>$form</tt>数据仍可用。接着视图可以填入用户输入的数据（这样用户就无需再次输入）并检查<tt>$error</tt>标记以在无效数据旁显示相应的错误消息。这些检查及消息在视图的<tt>tpl</tt>文件中。




== 子视图，*插件和*选项 ==
== 子视图，*插件和*选项 ==


Some views make it possible for other modules to add components, bringing different features together in a common user interface.  All three of the admin type views (<tt>core.SiteAdmin</tt>, <tt>core.ItemAdmin</tt> and <tt>core.UserAdmin</tt>) use "subviews" to group those functions together.  A subview is defined in a <tt>*.inc</tt> file and is written like a normal view.  The difference is the <tt>module.inc</tt> file will list the view in its <tt>[http://gallery.menalto.com/apidoc/GalleryCore/Classes/GalleryModule.html#methodgetSiteAdminViews getSiteAdminViews]</tt>, <tt>[http://gallery.menalto.com/apidoc/GalleryCore/Classes/GalleryModule.html#methodgetItemAdminViews getItemAdminViews]</tt> or <tt>[http://gallery.menalto.com/apidoc/GalleryCore/Classes/GalleryModule.html#methodgetUserAdminViews getUserAdminViews]</tt> function so a link for the view will appear in the sidebar of the appropriate admin area.  Note that subviews use their own controllers (there is no "subcontroller").
某些视图允许其他模块添加组件，将不同的特色带入常见的用户界面中。所有的三类管理型视图（<tt>core.SiteAdmin</tt>，<tt>core.ItemAdmin</tt>和<tt>core.UserAdmin</tt>）使用"子视图（subviews）"来讲这些功能组合在一起。子视图是在<tt>*.inc</tt>文件中被定义的，并被写为一个普通视图。区别就在于，<tt>module.inc</tt>文件会在其<tt>[http://gallery.menalto.com/apidoc/GalleryCore/Classes/GalleryModule.html#methodgetSiteAdminViews getSiteAdminViews]，<tt>[http://gallery.menalto.com/apidoc/GalleryCore/Classes/GalleryModule.html#methodgetItemAdminViews getItemAdminViews]</tt>或<tt>[http://gallery.menalto.com/apidoc/GalleryCore/Classes/GalleryModule.html#methodgetUserAdminViews getUserAdminViews]函数中列出视图，这样视图的链接会显示在管理区域边栏的适当位置中。注意，子视图使用自己的控制器（不存在"子控制器（subcontroller）"）。


Two subviews have additional levels of depth for adding user interface components.  <tt>core.ItemAdd</tt> and <tt>core.ItemEdit</tt> are both <tt>ItemAdmin</tt> subviews, but each includes too many options to show on a single page.  So each offers a plugin interface (not to be confused with the usual meaning of a Gallery plugin, which is a module or theme) to add components, which are shown as tabs.  Modules can register implementations of the <tt>[http://gallery.menalto.com/apidoc/GalleryCore/UserInterface/ItemAddPlugin.html ItemAddPlugin]</tt> or <tt>[http://gallery.menalto.com/apidoc/GalleryCore/UserInterface/ItemEditPlugin.html ItemEditPlugin]</tt> interface in the <tt>[http://gallery.menalto.com/apidoc/GalleryCore/Classes/GalleryModule.html#methodperformFactoryRegistrations performFactoryRegistrations]</tt> function to make these components available when the module is activated.  While registered in a different manner, these are still similar to subviews in that they control the main content of the page.  The final level of depth is <tt>[http://gallery.menalto.com/apidoc/GalleryCore/UserInterface/ItemAddOption.html ItemAddOption]</tt> and <tt>[http://gallery.menalto.com/apidoc/GalleryCore/UserInterface/ItemEditOption.html ItemEditOption]</tt>.  These are also factory registrations, but instead of defining an entire form they add just a section to a form and some processing upon form submission.  <tt>ItemAddOption</tt>s may add some form controls (such as the checkbox for whether to build thumbnails), or they may add no UI component and just perform post-processing (such as EXIF autorotate).  <tt>ItemEditOption</tt>s usually have both UI and post-processing, and also are registered to appear with a particular <tt>ItemEditPlugin</tt>.  For example, the thumbnail module adds its custom thumbnail controls to the ''General'' tab, as any item type can use a custom thumbnail.  The size limit module adds controls to the ''Album'' tab, as its settings are defined for an entire album.
两种子视图具有额外深度，用于用户界面组件的添加。<tt>core.ItemAdd</tt>和<tt>core.ItemEdit</tt>都是<tt>ItemAdmin</tt>的子视图，但各自所包括的选项在一个页面上显示不完。因此各自提供一个插件接口（不要理解为Gallery所指的插件，即所谓的模块或外观主题）来添加组件，这些组件将以标签的方式被显示出来。模块可以注册<tt>[http://gallery.menalto.com/apidoc/GalleryCore/Classes/GalleryModule.html#methodperformFactoryRegistrations performFactoryRegistrations]</tt>函数中的<tt>[http://gallery.menalto.com/apidoc/GalleryCore/UserInterface/ItemAddPlugin.html ItemAddPlugin]</tt>或<tt>[http://gallery.menalto.com/apidoc/GalleryCore/UserInterface/ItemEditPlugin.html ItemEditPlugin]</tt>接口来使得这些组件在模块激活情况下可用。当以不同方式注册时，这些仍与子视图相似，而在其中它们控制页面的主要内容。最深层是<tt>[http://gallery.menalto.com/apidoc/GalleryCore/UserInterface/ItemAddOption.html ItemAddOption]</tt>和<tt>[http://gallery.menalto.com/apidoc/GalleryCore/UserInterface/ItemEditOption.html ItemEditOption]</tt>。这些也是factory registration，但它们只向表单添加一个部分，在表单提交时添加一些处理，而不是定义整个表单。<tt>ItemAddOption</tt>会添加一些表单控制（比如是否建立缩略图的复选框），或者不添加UI组件而只是执行后置处理（比如EXIF autorotate）。<tt>ItemEditOption</tt>通常具有UI和后置处理，同时也会被注册并与一个特殊的<tt>ItemEditPlugin</tt>出现。比如缩略图（thumbnail）模块将其自定义的缩略图控制添加到''General''标签，任何项目类型能使用一个自定义缩略图。尺寸限制（size limit）模块向''Album''标签添加控制，其设定是为整个相册所定义的。


== 厂（Factory） ==
== 厂（Factory） ==


The *Option classes discussed above are two examples of factory interfaces.  Gallery uses this mechanism for all communication between modules.  A module defines an interface class that describes the functions of the interface.  This can be used in two ways: other modules can define implementations of the interface, allowing those implementations to be found and used.  This is how the *Option classes are discovered.  It is also how the search module allows other modules to make their data searchable. Alternatively, the module itself can implement the interface which allows other modules to use it.  This is how the EXIF module allows other modules to read EXIF data from image files.  Implementations are always registered in the <tt>[http://gallery.menalto.com/apidoc/GalleryCore/Classes/GalleryModule.html#methodperformFactoryRegistrations performFactoryRegistrations]</tt> function of <tt>module.inc</tt>.  The interfaces themselves don't need to be registered.
上面提到的*Option类别为factory接口的两个例子。Gallery对模块间的所有交流使用这种机制。模块定义接口类别，而接口类别则描述接口的功能。用途有二：其他模块可以定义接口的实现，允许其建立和使用。这就是*Option类别的发现所在。这同时也是search模块使得其他模块数据可搜索的原因。另外，模块自身也可以实现接口，从而允许其他模块使用该接口。这就是EXIF模块允许其他模块读取图片文件数据的原因了。这些implementation总是在<tt>module.inc</tt>的<tt>[http://gallery.menalto.com/apidoc/GalleryCore/Classes/GalleryModule.html#methodperformFactoryRegistrations performFactoryRegistrations]</tt>函数中进行注册的。接口自身无需进行注册。




== 事件侦听器 ==
== 事件侦听器 ==


Gallery includes an event system so that modules may take action when certain events take place.  For example, the ratings module listens for <tt>GalleryEntity::delete</tt> events and remove all ratings for an item when the item is deleted.  No registration is needed for event types; other modules just need to listen for the right event name.  Read more about [[Gallery2:Events|events]].
Gallery包括了一个事件系统，这样当特定事件发生时，模块就能执行对应的动作了。比如评价（ratings）模块侦听<tt>GalleryEntity::delete</tt>事件，因此当项目被删除时，它就会移除该项目所有的评价信息。事件类型无需注册，其他模块只需要为对应事件名称进行侦听。更多信息请参阅[[Gallery:Events|事件]]。




== 安全性 ==
== 安全性 ==


Security is a shared responsibility of modules and the Gallery framework.  The framework provides tools such as GalleryUtilities::getRequestVariables and GalleryCoreApi::assertHasItemPermission, but modules must also use these properly.  Other aspects of security are transparent to modules, and handled automatically by the framework, such as preventing [http://en.wikipedia.org/wiki/Session_hijacking session hijacking] or [http://en.wikipedia.org/wiki/Cross-site_request_forgery cross site request forgery].  Read more about [[Gallery2:Security|Gallery 2 Security]].
安全性为模块及Gallery框架的共同职责。框架提供如GalleryUtilities::getRequestVariables及GalleryCoreApi::assertHasItemPermission这样的工具，但模块必须合理地使用它们。安全性的其他方面对于模块是透明的，并自动为框架所处理，例如阻止[http://en.wikipedia.org/wiki/Session_hijacking 会话劫持]或 [http://en.wikipedia.org/wiki/Cross-site_request_forgery 跨站请求伪造]的发生。更多信息请参阅 [[Gallery:Security|Gallery2安全性]]。




== 会话管理 ==
== 会话管理 ==


Gallery manages user sessions automatically.  When a user logs in or a guest does something that requires saving state between requests (such as adding items to a cart), a persistent session is created.  Modules can store short-lived information in the session too.  This information is discarded if the user logs out or the session expires.  Gallery takes care of creating a [http://en.wikipedia.org/wiki/HTTP_cookie cookie] to track the session, or adding the session ID to all URLs in the page if the browser does not accept cookies.  Read more about [[Gallery2:GallerySession|session management]].
Gallery能自动管理用户会话。当某个用户登入或某个游客作出某种操作需要在请求见保存状态（比如向购物车添加项目）之时，一个对应的会话就会被创建。模块也可以保存会话中的短期信息。此信息在用户登出或会话过期时会被抛弃。Gallery会创建[http://en.wikipedia.org/wiki/HTTP_cookie cookie]来追踪会话；如果浏览器不接受Cookies的话，则会为页面中所有的URL地址添加会话ID。 更多信息请参阅：[[Gallery:GallerySession|会话管理]]。




== 国际化 ==
== 国际化 ==


Gallery is an internationalized application.  This means all user-visible text in the application can be translated for display in any language.  Modules make text available for translation by using the <tt>[http://gallery.menalto.com/apidoc/GalleryCore/Classes/GalleryPlugin.html#methodtranslate $module->translate()]</tt> or <tt>[http://gallery.menalto.com/apidoc/GalleryCore/Classes/Gallery.html#methodi18n $gallery->i18n()]</tt> functions in PHP code, and the <tt>[[Gallery2:Themes:Reference:Tags#text|{g->text}]]</tt> tag in <tt>tpl</tt> files.  Note that these translations are for text included with the application.  User entered text (such as image titles and captions) are not translated by this system.  The [[Gallery2:Modules:multilang|multilanguage module]] does make it possible to enter a few basic fields in more than one language.  Read more about [[Gallery2:Internationalization|internationalization]] and [[Gallery2:Localization|translations]].
Gallery是一个国际化的应用程序。这就意味着程序中所有用户可见的文本可以翻译为任何语言。通过在PHP代码及<tt>[[Gallery:Themes:Reference:Tags#text|{g->text}]]</tt> tag in <tt>tpl</tt>文件中使用<tt>[http://gallery.menalto.com/apidoc/GalleryCore/Classes/GalleryPlugin.html#methodtranslate $module->translate()]</tt>或<tt>[http://gallery.menalto.com/apidoc/GalleryCore/Classes/Gallery.html#methodi18n $gallery->i18n()]</tt>函数，模块使得文本可翻译。注意这些翻译是针对应用程序所包含的文本的。用户输入的文本（比如图片标题和字母）不会被翻译出来。[[Gallery:Modules:multilang|多语言（multilanguage）模块]]允许输入多种语言。更多信息请参见[[Gallery:Internationalization|国际化]]和[[Gallery:Localization|翻译]]。




== 接下来的步骤 ==
== 接下来的步骤 ==


Check the available documents in the [[:Category:Gallery 2:Development|Gallery 2 Development]] category to find additional detail on these and other topics.  Particularly look for the [[Gallery2:Module Development Tutorial|Module development tutorial]] and information about the [[Gallery2:API|Gallery 2 APIs]].  Also, once you understand the basics, looking at existing code is a great way to learn how to accomplish various tasks in Gallery code.  You can also visit the <tt>#gallery</tt> channel on irc://chat.freenode.net to ask development questions.  Good luck!
在[[:Category:Gallery 2:Development|Gallery2开发]]分类中查找详细信息及其他相关话题。特别关注一下 [[Gallery:Module Development Tutorial|模块开发教程]]以及有关[[Gallery:API|Gallery2 API]]的信息。另外，一旦你掌握了基础，学习现有代码是一条了解Gallery代码如何完成各类任务的好路子。你还可以访问<tt>#gallery</tt> channel on irc://chat.freenode.net来提问。祝好运！




[[Category:Gallery 2:Development|Code Overview]]
[[Category:Gallery 2:Development|Code Overview]]

2008年11月26日 (三) 14:44的最新版本

代码回顾[ ]

该页面描述Gallery2应用程序的基本结构以及一些高级设计概念。它能帮你在开发新模块，外观主题或修改现有代码之前找到门路。它能帮助读者了解面向软件编程以及基于web的应用程序。

Gallery2是一个PHP应用程序，它使用单个入口点来处理所有的HTTP请求：main.php。此脚本会读取你的配置文件（config.php）然后检查某些基础参量，这样它就能将请求处理转为正确的代码了。Gallery使用 [1]的设计模式（尽管使用的是松散定义的模型）。简言之就是，视图用于显示而控制器用于发出动作。所以main.php决定处理请求由哪个视图或控制器进行控制，并会将控制权移交给选择。视图是被包裹在一个外观主题系统中的，这样就能使得网站建立者可以对网站布局和外观进行控制，而只需要牵涉到最少的PHP代码就可以达到目的。

img:146290

视图[ ]

模块在模块目录的*.inc文件中对视图（扩展类别Gallery视图）进行定义。有两类视图：

标准视图（Standard Views）： 这些视图在应用程序中创建一个HTML页面。要将代码从用户界面中分离出来的话，所有页面创建所需的数据都会先被载入。数据容器为Gallery模板。视图会读取其所需的任何数据，然后外观主题（外观主题也会载入某些数据）则接手并对页面进行渲染。

即时视图（Immediate Views）： 这些应特殊目的而存在的视图会绕过外观主题系统并直接发送输出。这可发送非HTML的输出，如binary或XML数据。即时视图也可用于AJAX请求，其中javascript代码能与Gallery服务器后台进行交互，并在结果返回时动态更新页面。某些AJAX视图可能会将更改保存到数据库（也有争议说这些应是控制器）。

  • 技术注解：一个即时视图包括一个返回true值的isImmediate函数；一个保存更改的AJAX视图还应包括一个返回true值的isControllerLike函数。


外观主题[ ]

外观主题对Gallery页面布局和外观具有完全的控制。Gallery框架决定访问页面的类型并在活动外观主题的theme.inc文件中呼叫六种函数之一。（扩展类别Gallery外观主题）。

  • showAlbumPage或showPhotoPage：显示单个或组合的Gallery项目
  • showModulePage：由模块添加的其他Gallery页面
  • showAdminPage：Gallery管理页面；它们如模块页面般运行，但如果外观主题要自定义浏览器管理页面的显示的话，就会呼叫外观主题函数
  • showErrorPage：main.php将错误引导至core.ErrorPage视图
  • showProgressBar：控制器会将控制委任给core.ProgressBar视图以运行任务

各函数将额外所需的数据载入到模板中，然后为页面显示指定一个tpl文件。在大多数情况下，此为theme.tpl。首先呼叫theme.tpl文件会创建其他页面类型的wrappera，并在所有Gallery页面中保持一致的基本外观（头，横幅等）。theme.tpl接着会重检页面类型，并针对被请求的Gallery内容包括进相关的tpl。有关外观主题和模板系统的详细信息

控制器[ ]

控制器执行动作将更改保存到服务器上。添加新相片或评论，修改设定，甚至是登入，这些都是由控制器进行处理的。控制器扩展了GalleryController类别，而它们的代码则位于模块目录及视图的*.inc文件中。

一般说来，控制器首要任务就是针对被请求的动作，进行权限确认。切记就算你的视图缺失了某些基于权限的按钮或链接，控制器还是必须检查权限，因为HTTP请求可以手动建立。

第二个任务就是认证输入数据。如果某用户输入的数据丢失或无效，控制器就标记将要返回的$error数组。仅当输入有效时，控制器才会继续操作并在$success 数组中设置一个key。接着，控制器就会指导main.php的后续操作。成功时，控制器通常就会向相同的视图发送一个redirect。$success数据被保存在会话中，并在接下来的请求中可用于视图，因此它可以显示一个状态消息。如果$error非空，通常控制器就会委任给相同的视图。这就意味着视图在相同的HTTP请求中被渲染，因此给定的$form数据仍可用。接着视图可以填入用户输入的数据（这样用户就无需再次输入）并检查$error标记以在无效数据旁显示相应的错误消息。这些检查及消息在视图的tpl文件中。


子视图，*插件和*选项[ ]

某些视图允许其他模块添加组件，将不同的特色带入常见的用户界面中。所有的三类管理型视图（core.SiteAdmin，core.ItemAdmin和core.UserAdmin）使用"子视图（subviews）"来讲这些功能组合在一起。子视图是在*.inc文件中被定义的，并被写为一个普通视图。区别就在于，module.inc文件会在其getSiteAdminViews，getItemAdminViews或getUserAdminViews函数中列出视图，这样视图的链接会显示在管理区域边栏的适当位置中。注意，子视图使用自己的控制器（不存在"子控制器（subcontroller）"）。

两种子视图具有额外深度，用于用户界面组件的添加。core.ItemAdd和core.ItemEdit都是ItemAdmin的子视图，但各自所包括的选项在一个页面上显示不完。因此各自提供一个插件接口（不要理解为Gallery所指的插件，即所谓的模块或外观主题）来添加组件，这些组件将以标签的方式被显示出来。模块可以注册performFactoryRegistrations函数中的ItemAddPlugin或ItemEditPlugin接口来使得这些组件在模块激活情况下可用。当以不同方式注册时，这些仍与子视图相似，而在其中它们控制页面的主要内容。最深层是ItemAddOption和ItemEditOption。这些也是factory registration，但它们只向表单添加一个部分，在表单提交时添加一些处理，而不是定义整个表单。ItemAddOption会添加一些表单控制（比如是否建立缩略图的复选框），或者不添加UI组件而只是执行后置处理（比如EXIF autorotate）。ItemEditOption通常具有UI和后置处理，同时也会被注册并与一个特殊的ItemEditPlugin出现。比如缩略图（thumbnail）模块将其自定义的缩略图控制添加到General标签，任何项目类型能使用一个自定义缩略图。尺寸限制（size limit）模块向Album标签添加控制，其设定是为整个相册所定义的。

厂（Factory）[ ]

上面提到的*Option类别为factory接口的两个例子。Gallery对模块间的所有交流使用这种机制。模块定义接口类别，而接口类别则描述接口的功能。用途有二：其他模块可以定义接口的实现，允许其建立和使用。这就是*Option类别的发现所在。这同时也是search模块使得其他模块数据可搜索的原因。另外，模块自身也可以实现接口，从而允许其他模块使用该接口。这就是EXIF模块允许其他模块读取图片文件数据的原因了。这些implementation总是在module.inc的performFactoryRegistrations函数中进行注册的。接口自身无需进行注册。


事件侦听器[ ]

Gallery包括了一个事件系统，这样当特定事件发生时，模块就能执行对应的动作了。比如评价（ratings）模块侦听GalleryEntity::delete事件，因此当项目被删除时，它就会移除该项目所有的评价信息。事件类型无需注册，其他模块只需要为对应事件名称进行侦听。更多信息请参阅事件。


安全性[ ]

安全性为模块及Gallery框架的共同职责。框架提供如GalleryUtilities::getRequestVariables及GalleryCoreApi::assertHasItemPermission这样的工具，但模块必须合理地使用它们。安全性的其他方面对于模块是透明的，并自动为框架所处理，例如阻止会话劫持或 跨站请求伪造的发生。更多信息请参阅 Gallery2安全性。


会话管理[ ]

Gallery能自动管理用户会话。当某个用户登入或某个游客作出某种操作需要在请求见保存状态（比如向购物车添加项目）之时，一个对应的会话就会被创建。模块也可以保存会话中的短期信息。此信息在用户登出或会话过期时会被抛弃。Gallery会创建cookie来追踪会话；如果浏览器不接受Cookies的话，则会为页面中所有的URL地址添加会话ID。 更多信息请参阅：会话管理。


国际化[ ]

Gallery是一个国际化的应用程序。这就意味着程序中所有用户可见的文本可以翻译为任何语言。通过在PHP代码及{g->text} tag in tpl文件中使用$module->translate()或$gallery->i18n()函数，模块使得文本可翻译。注意这些翻译是针对应用程序所包含的文本的。用户输入的文本（比如图片标题和字母）不会被翻译出来。多语言（multilanguage）模块允许输入多种语言。更多信息请参见国际化和翻译。


接下来的步骤[ ]

在Gallery2开发分类中查找详细信息及其他相关话题。特别关注一下 模块开发教程以及有关Gallery2 API的信息。另外，一旦你掌握了基础，学习现有代码是一条了解Gallery代码如何完成各类任务的好路子。你还可以访问#gallery channel on irc://chat.freenode.net来提问。祝好运！

取自“https://www.zzbaike.com/wiki/index.php?title=Gallery:代码概览&oldid=16315”