Zoph/使用网络界面

本手册将介绍如何开始使用 Zoph。它假设您已成功安装所有组件，并且在访问https://127.0.0.1/zoph/logon.php时会显示登录屏幕。

首次登录

在您加载数据库时创建了一个管理员用户。您应该能够使用密码“admin”以“admin”身份登录。您将看到 Zoph 的主页，在那里您将被问候为“未知人员”。将有一个空白方块，通常会显示随机照片。

您应该做的第一件事是更改管理员的密码

点击“prefs”选项卡。
点击“更改密码”链接。
输入新密码并点击“提交”。

接下来，为您自己创建一个“person”记录

点击“people”选项卡。
点击右侧的 [ new ] 链接。
填写您的名字、姓氏以及您希望的任何其他字段。
点击“插入”按钮。

现在为您自己创建一个用户

点击“admin”选项卡。
点击“users”图标。
点击 [ new ]。
选择一个用户名和密码。
从人员下拉菜单中选择自己。
将您的类别更改为管理员。
点击“插入”按钮。

管理员有权执行任何操作，因此您无需授予特定的“浏览”或“查看详细信息”权限，也不需要授予对各个相册的权限。

现在您已经创建了一个用户

点击“logout”选项卡。
以您的用户身份登录。

创建相册、类别和地点

在导入一些图像之前，我们将创建一个相册来放置它们。请注意，如果您不想分配照片，则无需将照片分配给相册。

要创建相册

点击“albums”选项卡。
点击 [ new ]。
选择一个相册名称。在本示例中，我使用“Zoph 教程”。
如果您愿意，可以添加相册描述。这可以留空。
点击“插入”按钮。

要创建类别，请点击“category”选项卡，然后执行与上面相同的操作。在本教程的创建过程中，我拍了一张手的照片，因此我为其创建了一个“附属物”类别。

相册和类别本质上都是分层结构（每个条目都可以有子条目）。当您在 Zoph 中查看相册或类别中的照片时，您也会自动看到放置在该相册或类别的子条目中的照片。

要创建地点

点击“places”选项卡。
点击 [ new ]。
至少输入一个标题和城市。
点击“插入”按钮。

导入照片

在您的 Zoph 安装启动并运行后，下一步是向其中添加照片。在 Zoph 中有 3 种导入照片的方法

使用网络界面上传和导入照片
将照片放置在上传目录中，并使用网络界面导入照片
使用命令行界面 (CLI) 工具导入照片。

前两种方法在使用网络界面导入照片中进行了描述，最后一种方法在使用 CLI中进行了描述。

查看照片

现在数据库中有一些照片了，我将介绍网络界面的某些功能。UI 相当直观，因此您可能真的不需要阅读本节。

查找照片

有很多方法可以找到您刚刚输入的照片，其中一些方法是

浏览到您创建的相册，然后点击 [ view photos ]。
浏览到“people”中的自己，然后点击 [ photos by ]。
浏览到您拍摄照片的地点，然后点击 [ photos at ]。
使用搜索表单。不指定任何条件将显示所有照片。
使用“photos”选项卡，您可以浏览 Zoph 中的每张照片。

结果页

默认情况下，结果页将显示最多 12 张照片的缩略图（您可以从“prefs”页面更改此设置）。在 prefs 页面上，您还可以选择是否在缩略图下方显示描述。

在此页面上，您可以

点击缩略图以转到照片页。
点击 [ Prev ] 或 [ Next ]，或使用分页器来翻页（如果您的结果跨越多个页面）。
点击 [ Slideshow ] 进入幻灯片模式。
从下拉菜单中选择一个字段来重新排序照片。
点击其中一个三角形来更改排序方向。白色三角形/箭头表示当前方向。
更改显示的行数和列数。

照片页

在这里，您将看到照片的中等大小版本以及所有可用的照片信息。

在此页面上，您可以

点击文件名或图片本身可以查看全尺寸照片。
点击人物、地点、相册、类别或日期可以跳转到相应的页面。
点击“[ Prev ]”或“[ Next ]”可以在结果页面上浏览照片。
点击“[ email ]”可以将照片发送到电子邮件（如果设置了 EMAIL_PHOTOS）。
点击“[ lightbox ]”可以将照片添加到你的灯箱（如果你有灯箱）。
点击“[ edit ]”或“[ delete ]”（如果你是一个管理员或被授予了该照片所属相册的写入权限）。

如果你设置了自动编辑偏好，每当你点击缩略图时，系统会自动显示字段让你编辑照片信息。点击“[ return ]”可以返回到常规视图。

幻灯片

幻灯片模式（从结果页面进入）将通过刷新浏览器窗口循环播放当前的一组照片。刷新之间的间隔可以在“偏好”页面上设置。

在幻灯片页面上，你可以

点击“[ pause ]”可以暂停幻灯片。
点击“[ stop ]”可以返回到结果页面。
点击“[ open ]”可以查看当前照片的正常照片页面。

搜索页面

你可以在搜索页面上使用多个条件搜索照片。注意，当你选择一个相册或类别时，所有子相册或类别也会自动被选中。

默认情况下，所有条件都用“and”连接。你可以从最左侧列的下拉菜单中选择“or”。由于你不能指定条件的组合，因此如果你尝试使用不同的连接词构建复杂的查询，你可能无法获得想要的结果。

注意，相册、类别、地点、人物和摄影师菜单已被修剪，只显示用户有权访问的照片中实际出现的条目。

随机照片

“主页”上显示的缩略图是随机选择的。我倾向于喜欢这种照片，所以我在“偏好”页面上创建了一个设置，让你可以指定选择随机照片时使用的最低评分。

如果你想创建无限循环的随机照片幻灯片，你可以通过点击主页上的“随机选择的照片”链接来实现。然后，如果你点击结果页面上的“[ Slideshow ]”链接，每次幻灯片都会选择一张新的随机照片。

灯箱

灯箱为用户提供了一个收集和分享他们喜欢的照片的地方。在 Zoph 中，灯箱只是相册。在编辑用户时，管理员可以将某个相册声明为该用户的灯箱。管理员还必须授予用户查看灯箱相册的权限。

重要：不要授予用户对他们灯箱相册的写入权限。用户可能会将任何照片添加到他们的灯箱，并能够编辑它。

每当用户查看照片时，他们可以点击“灯箱”链接，该链接会将该照片添加到他们的灯箱。当用户查看他们的灯箱时，每张照片下方都会有一个“x”。点击它会将该照片从灯箱中移除。

灯箱允许用户收集他们感兴趣的照片，而无需编辑照片以将其放入相册。

灯箱只有在指定了灯箱相册后才会为用户激活。我使用的设置是创建一个“灯箱”相册，并在该相册下为每个用户的灯箱创建单独的相册（例如，“Jason's Lightbox”）。

要分享灯箱，管理员必须授予其他用户对该相册的权限。

管理用户、组和限制访问

Zoph 的一项功能是它的访问权限系统。你已经为你自己创建了一个管理员类用户。如果你愿意，你也可以创建其他用户。

用户

创建新的用户帐户

使用管理员帐户登录。
点击菜单栏中的“admin”。
点击“users”。
点击屏幕右上角的“new”。
指定用户名（例如：首字母+姓氏）。
如果用户也在你的数据库中以“人物”的身份存在（例如，因为他或她拍摄了照片或出现在照片中），请指定一个人物，否则保持为“未知人物”。
指定密码
选择用户类别：管理员可以做任何事情。用户有限制。在这种情况下，你可以指定用户除了照片之外还能看到什么
- 浏览人物：用户可以查看“人物”页面，其中显示了数据库中存储的所有人物。
- 浏览地点：用户可以查看“地点”页面，其中显示了数据库中存储的所有地点。
- 人物详细信息：如果为“Yes”，用户可以查看任何人物的所有信息。如果为“No”，用户只能看到人物的姓名。
- 地点详细信息：如果为“Yes”，用户可以查看任何地点的所有信息。如果为“No”，用户只能看到地点的标题和城市。
- 导入：如果为“Yes”，用户可以导入照片
- 下载 zip 文件：如果为“Yes”，该用户可以下载一组照片（相册、类别、搜索结果等）作为 zip 文件。
- 发表评论：如果为“Yes”，该用户可以对照片发表评论。
- 评分照片：如果为“Yes”，该用户可以评分照片。
- 多次评分照片：如果为“Yes”，该用户可以对同一张照片评分多次。如果你创建了一个由多人使用的帐户，请使用此选项。每张照片每个 IP 地址只能评分一次。
- 灯箱：用户的灯箱相册
点击“insert”。
将用户添加到一个或多个组。请参阅groups了解如何操作。

修改或删除用户帐户

使用管理员帐户登录。
点击菜单栏中的“admin”。
点击“users”。
点击你要修改的用户。
点击“edit”或“delete”。
进行必要的更改或确认删除。
- 有关字段的说明，请参阅创建新的用户帐户。

组

为了授予用户查看照片的权限，你必须创建一个或多个组，然后你可以将访问权限授予这些组的相册，例如，你可以创建一个“family”组，一个“colleagues”组和一个“friends”组。用户可以是多个组的成员，Zoph 会将所有组的访问权限合并在一起。

创建组

使用管理员帐户登录。
点击菜单栏中的“admin”。
点击“groups”。
输入组名。
如果需要，输入描述。
点击“insert”。
你将自动被带到编辑组屏幕。请参阅修改组以获取解释。

修改组

使用管理员帐户登录。
点击菜单栏中的“admin”。
点击“groups”。
点击你要编辑的组名旁边的“display”。
点击“edit”。
你可以更改组名或描述，并添加或删除成员。
- 如果你修改了组名，所有成员将自动更改到新组。
- 从列表中选择一个用户以将其添加到组中。
- 要从组中删除成员，请选中用户名前面的复选框。
点击“update”。
- 此屏幕有两个“update”按钮，请确保点击上面的按钮以进行这些修改。
要将相册添加到该用户可以查看的列表中，请使用“grant access to all existing albums”或添加特定相册。
- 有关更详细的解释，请参阅albums。
点击“update”。
- 此屏幕有两个“update”按钮，请确保点击下面的按钮以进行这些修改。
- 请确保修改此屏幕的上半部分或下半部分，而不是同时修改两部分。

相册

对于非管理员用户，查看照片的权限是在每个相册的基础上授予的。对于你授予某个组访问权限的每个相册，你必须指定

访问级别
水印级别（如果你在config.inc.php: 请参阅水印。
该相册是否可写。

Zoph 通过检查两件事来确定用户是否有权访问照片。

此照片是否位于用户所属的至少一个组有权访问的相册中？
如果是，该组对该相册的访问级别是否大于或等于照片的级别？

如果满足这两个条件，则用户有权访问该照片。

如果照片出现在多个相册中，用户只需对其中一个相册拥有权限即可查看照片。如果用户有权访问包含照片的多个相册，或者用户有多个组授予访问照片的权限，则使用最不严格的（最高访问级别）权限。

照片的级别（以及访问级别的级别）可以从 0 到 10。默认访问级别为 5。

Zoph 的设计使得这些特权应该透明地工作。对任何用户来说，他们应该有权访问所有照片。对于用户无权访问的任何相册或照片（包括照片数量）不应该有任何引用。

如果相册被标记为可写，则该组的成员可以编辑（但不能删除）他们在该相册中拥有访问权限的照片。

如果要授予某个组对所有相册的访问权限，您可以一次性完成此操作，访问级别和可写标志将应用于每个相册。如果您想让某人看到所有内容，但不想让他们更改任何内容，这将非常有用。

请注意，在您创建新相册时，您必须在非管理员可以查看这些相册之前向他们授予权限。

水印

您可以让 Zoph 在全尺寸图片上叠加水印。如果您希望用户能够查看高质量的图片，但不能将它们用于出版，则可以使用此功能。要使用此功能，必须启用图像服务。Zoph 将在每个级别高于水印级别的照片上添加水印。

场景

访问级别

假设您为父母创建了一个帐户，但您不希望他们看到“新年派对”相册中的照片。只需不授予他们对该相册的权限即可。

但是，假设该相册中的照片大多是无害的，除了几个您想隐藏的。在这种情况下，将这些照片的级别更改为 6（或更高），并授予用户以访问级别 5（或更低）访问相册的权限。

水印

您拍摄了几张精彩的风景图片。您真的很想向您的一个常客展示它们，但您担心他们会简单地拿走您的图片并发布，而不付费。您将照片放在一个名为“景观”的相册中，并将它们的级别设置为 3。

之后，您为客户帐户提供访问级别 5 和水印级别 2。他们现在可以观看照片，但当他们查看全尺寸图片时，一个大型版权信息将叠加在照片上。这样，他们就可以判断图片的质量，但它在他们的作品中将无法使用。

在他们为照片付费后，您可以将图片放到一个允许他们查看没有水印的照片的相册中，更改照片的级别或更改水印级别。（请记住，后两者也会影响其他帐户或照片，分别）。

定义默认用户

从 Zoph 0.2.1 开始，可以定义默认用户。当用户第一次在浏览器中打开 Zoph 时，该用户会自动登录。

如果您在本地使用 Zoph，您可能希望将自己设为默认用户，这样您就不必再登录了。您可能还想使用此功能来创建一个具有有限权限的访客帐户。

要创建访客用户，首先创建一个与用户关联的人员记录（这可能只是名字为访客，姓氏为用户）。然后创建一个访客用户，授予该用户您想要的任何权限并设置用户的偏好。无论哪个用户被定义为默认用户，他们都无法在他们是默认用户时修改他们的偏好。

您现在需要找到访客用户的 user_id。最简单的方法可能是查看您在 zoph 中查看用户记录时的 url（user.php?user_id=3）。

默认用户在 config.inc.php 中定义。

// set to the id of a non admin user or to 0 to disable
// note that this is a user_id, not a person_id
define(DEFAULT_USER, 3);

就是这样。现在，当您第一次访问 /zoph/zoph.php 时，您将以访客用户身份登录（如果您已经以其他身份登录，则首先需要注销）。您也可以在您是访客用户时注销，以便能够以其他身份登录。

如果访客点击注销并想要重新登录，但不知道访客帐户信息怎么办？在登录页面上点击提交，而不指定用户名或密码，将以默认用户身份登录。

页面、页面集和 ZophCode

默认情况下，每个相册、类别、地点和人员都有一个页面，该页面将显示有关此对象的基本数据。在某些情况下，您可能希望自定义此页面。从 Zoph 0.7.2 开始，可以使用 ZophPages 功能来做到这一点。

ZophCode

ZophPage 使用 ZophCode 编写。ZophCode 与 bbCode 或 html 非常相似，由方括号中的标签组成。当前支持的标签是

ZophCode
标签	含义	示例
[b]...[/b]	粗体	您可以使文本 [b]变为粗体[/b]。
[i]...[/i]	斜体	要 [i]强调[/i] 一个词...
[u]...[/u]	下划线	[u]下划线[/u] 一个词。
[h1]...[/h1]	一级（章）标题	[h1]我的假期[/h1]
[h2]...[/h2]	二级（段落）标题	[h2]第二天[/h2]
[h3]...[/h3]	三级（子段落）标题	[h3]下午[/h3]
[color=<color>]...[/color]	文字颜色。	以 [color=blue]蓝色[/color] 和 [color=#ff0000]红色[/color] 的词语。
[font=<font>]...[/font]	文字字体	混合 [font=times]字体[/font] 可以使您的 [font=courier]页面[/font] 看起来专业（或凌乱）。
[br]	换行	此致敬礼，[br]Jeroen
[background=<color>]...[/background]	背景颜色	[background=blue]蓝色背景[/background]
[photo=<id>]...[/photo]	链接到照片	[photo=123]查看此照片！[/photo]
[album=<id>]...[/album]	链接到相册	[album=123]查看此相册！[/album]
[person=<id>]...[/person]	链接到人员	[person=123]查看此人员！[/person]
[cat=<id>]...[/cat]	链接到类别	[cat=123]查看此类别！[/cat]
[place=<id>]...[/place]	链接到地点	[place=123]查看此地点！[/place]
[link=<url>]...[/link]	链接到网页	[link=http://www.zoph.org]Zoph[/link]
[thumb=<id>]	照片的缩略图	[thumb=123]
[mid=<id>]	照片的中等尺寸图像	[mid=123]

可以嵌套标签。例如

[h1]Holiday in [b]Spain[b][/h1]
[i]more [u]emphasis[/u] by [b]combining[/b] tags[/i].
Click on this thumbnail to see the photo: [photo=123][thumb=123][/photo]

只需确保您按正确的顺序打开和关闭标签即可。

[b]This [i]will[/b] not[/i] work!

最后，您可以使用表情符号。请参阅 #评论了解概述。

页面

您可以通过进入管理页面并点击“页面”来创建一个新页面。只需输入您的文本和标签，然后保存即可。如果您想将内容分散到多个页面，只需保存此页面并创建另一个页面。

页面集

下一步是将一个或多个页面组合成一个页面集。请记住，如果您只有一个页面，您仍然需要将其放入页面集。从管理页面创建一个页面集，并将您想要包含在这个页面集中的页面添加到其中。您还可以通过点击“向上移动”和“向下移动”来定义页面在页面集中出现的顺序。

您还需要决定如何处理 Zoph 为每个专辑、类别、地点和人物自动创建的原始页面。您可以选择从不显示它，在第一页、最后一页或每页上显示它。您还可以选择是否希望首先看到您自己的页面或自动生成的页面。请记住，如果您选择从不显示原始页面，您可能会限制用户的导航。例如，如果您有一个包含几个子专辑的专辑，您的用户将无法导航到这些子专辑，除非您在页面中提供指向这些子专辑的链接（并在每次添加新子专辑时添加新链接）。

将页面集分配给对象

启用 ZophPages 功能的最后一步是将页面集分配给专辑、类别、地点或人物。您可以通过编辑特定对象并选择页面集来实现。

偏好设置

用户可以使用偏好设置页面自定义 Zoph。以下是几个偏好设置的描述。

在选项卡和标题栏之间，您默认会看到一个面包屑导航列表。在偏好设置页面上，您可以指定要显示的面包屑数量，或者您可以选择完全禁用面包屑导航。

关于面包屑导航的一个说明：点击面包屑导航右侧的小 x 会清除面包屑列表。

选择语言

默认值为“浏览器默认”。这意味着 Zoph 将尝试以您在浏览器设置中指定的语言显示自身。如果您的浏览器列表中没有任何语言的翻译，则默认情况下将显示英文。

如果您在偏好设置页面上指定了一种语言而不是“浏览器默认”，您的设置将覆盖您在浏览器中设置的任何语言。

语言文件存储在 php/lang 中。创建一个新翻译需要在这个目录中创建一个文件，文件名使用语言的两位字母代码，小写。以现有的（非英语）语言文件作为示例。

其他偏好设置

以下是其他一些偏好设置的描述。

最近照片链接的过去天数：主页上有一些链接，可以查看在过去 X 天拍摄或修改的照片，这个偏好设置用于设置天数。
显示相机信息：如果设置为“否”，则在查看照片的详细信息时，不会显示诸如相机品牌和型号、焦距、曝光等字段。
自动编辑照片：如果设置为“是”，则当管理员或具有写入权限的用户查看照片的详细信息时，他们会立即被带到编辑屏幕。这对连续编辑多个照片很有帮助。
配色方案：要使用的配色方案。管理员可以点击“配色方案”来添加、编辑和删除配色方案。

备份您的数据

定期备份您的照片总是一个好主意。定期将照片同步到另一台机器上或刻录到 CD 上。Zoph 永远不会删除您的照片，当您从界面中删除某些内容时，只有数据库记录会被删除。

您还应该定期导出数据库。在您花费数小时将照片插入和更新到 Zoph 之后，花两秒钟做以下操作。

> mysqldump -u zoph_admin -p zoph > zoph-`date +%Y%m%d`.sql

集成 Zoph

在本节中，我想提几个建议，如果您有兴趣尝试将 Zoph 与您网站的其他部分集成。这仍在进行中。

查找人物

假设您有一个网站，它有自己的个人或用户记录，并且您希望在这两个系统之间进行映射（例如，您想要在用户的个人资料页面上放置一个“照片”链接）。虽然 Zoph 通常使用自己的 person_id 字段，但您可以传递一个名称来代替。

http://www.zoph.org/demo/photos.php?person=Jason%20Geiger

将显示一个人的照片。您也可以使用“摄影师”。

http://www.zoph.org/demo/photos.php?photographer=Jason%20Geiger

或者，您可以跳到个人页面，而不是跳到照片页面。

http://www.zoph.org/demo/person.php?person=Jason%20Geiger

其他查找

对于专辑、类别和地点，目前尚不存在此类查找。但是，如果有人有兴趣，它们很容易集成。

当然，很容易为其他照片字段（不需要联接）生成 URL，例如标题或描述。只需调用 photos.php?field=val 即可。任何不以下划线开头的字符串都被认为是要搜索的字段。