Zoph/使用網路介面

本手冊將介紹如何開始使用 Zoph。它假設您已成功安裝所有元件，並且在訪問https:///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 即可。任何不以下劃線開頭的字串都被認為是要搜尋的欄位。