编辑“Gallery:如何编写脚本”

你可以编写模块及主题来对Gallery的功能进行扩展，你也可以使用自己编写的脚本。.

应用程序（举例）：
* 基于cron周期性地运行任务—相当于一个等程序（scheduler）呼叫PHP脚本来执行Gallery中的某些操作。
* 编写自定义脚本来批量导入大量用户信息及评论等。
* ...

请注意我们并不是让你从零开始颇费周章地重新编写脚本。如果你在寻求一个命令行客户端程序，以用来添加项目的话，请参看一下：[[Other_Clients|其他客户端程序列表]]。

== 脚本的基本结构 ==
[http://gallery.menalto.com/apidoc/GalleryCore/Classes/GalleryEmbed.html GalleryEmbed API]不仅能够胜任Gallery[[Gallery:Embedding|整合]]如其他web应用程序的工作，而且在编写命令行脚本方面也有很大的作用：

<pre>
<?php
/* 调整路径使其指向你的gallery2文件夹 */
require_once('../gallery2/embed.php');

/*
 * 初始化G2（包括所有必要类别，
 * 令G2处于随时准备处理呼叫的状态）
 */
$ret = GalleryEmbed::init(array('fullInit' => true));
check($ret);

/* 这里是你的G2 API呼叫 */


/*
 * 最后，呼叫::done()来提交数据库事务对象
 * 或者以上作出的所有修改都会自动回滚
 */
$ret = GalleryEmbed::done();
check($ret);

function check($ret) {
    if ($ret) die($ret->getAsHtml());
}
?>
</pre>

== 可用API ==
GalleryEmbed::init()呼叫完成后，你可以使用[[Gallery:API|Gallery的所有API]]（GalleryCoreApi，GalleryModuleApi…）。

== 实例 ==
* [http://gallery.menalto.com/node/42333#comment-160089 在不丢失字幕及评论等的前提下，重新上传/重复扫描所有图片]
* [http://gallery.menalto.com/node/60419#comment-220510 由外部数据源批量导入用户信息]

[[Category:Gallery 2:Administration and Maintenance]]