Installation

1. Check the web server and database on your system. PHP4 or PHP5 must be supported by your web server, the recommended version is PHP5. MySQL database server must be installed, the recommended version is MySql v5.0 .

2. Unzip JetPhoto Server Pro package, and copy all contents in folder jpserver to the http documents path of your web server.

3. With your web browser, go to the root path of the JetPhoto Server that you just installed, for example: http://127.0.0.1/jpserver/ . And then you should see a detailed report of server diagnostics, that will guide you to set up your server environment step by step.

4. PHP environment setup:
- PHP option short_open_tag must be enabled in PHP configuration (php.ini) file.
- XML, MySQL libraries are required. JetPhoto Server can not run without these PHP libraries.
- GD library is required to run some specific image rendering functions in JetPhoto Server. Example, to generate verify code images. But JetPhoto Server main program can still work if GD library is not loaded in the PHP system.

5. Database setup:
A valid MySQL database is required for JetPhoto Server running. Need first edit database connection configuration file /site/config/jpserver_config.php in JetPhoto Server home path, and set MySQL server address, user name, password and database name there. A typical configuration file is as below:

$db_host="127.0.0.1";
$db_user="root";
$db_pass="123456";
$db_name="jetphoto";

For this sample, a MySQL server is installed on 127.0.0.1 (localhost). The user to login the MySQL server is root, and the password is 123456. A blank database named jetphoto has been created in your MySQL server. You need manually create the new database by a MySQL admin tool, such as MySQL Administrator or phpMyAdmin. But you needn't manually create tables, the database setup program will automatically create all necessary data tables used by JetPhoto Server Pro in this database later.

Then go to the server diagnostics page. Click 'Database Setup' link there, and continue to click 'Initialize Database Now!' button to create all necessary tables and finish database setup.

6. File access permissions setup:
The uploaded files need to be saved in some special folders on JetPhoto Server.
jpserver/site/images/ is for storing uploaded site banner and logo files;
jpserver/data/ is for storing uploaded album file packages;
jpserver/media/files/ is for storing uploaded media files;
jpserver/media/tmp/ is for storing temporary files.

If your web server works on Unix, Linux or Mac OS X system, you must set the file access permissions of these folders to allow the web service daemon can write files there. If uses Microsoft IIS on a Windows server, you also need grand the write permission to these folders in Internet Services Manager.

7. Then go to jpserver/web/default/ to see your JetPhoto Server home page. And go to jpserver/web/admin/ to see the administration page, the default user name is 'admin' and password is '123456' .

 

Publishing Web Albums

After installing JetPhoto Server Pro, users also need use a desktop software named JetPhoto Studio to organize their photo albums, and upload albums to the website using WebSync. You can go to www.jetphotosoft.com to download a free JetPhoto Studio and run it on your Mac or Windows PC.

You can create albums on your desktop computer with JetPhoto Studio, and:

Add photos - drag and drop photo files into Thumbnail view in the album main window.
Sort photos - choose menu item 'Edit' -> 'Arrange Photos' to sort photos by capture time automatically, or use mouse to move photo thumbnails to rearrange photos manually.
Set photo descriptions and keywords - Edit them in 'Notes' side panel.
Set album title and description - Edit them in 'Album' tabbed panel in the album main window.
Set album cover photo - Select a photo in the album, and enable option 'Cover Photo' with clicking the check box in 'Notes' side panel.

Once your photo album is organized in JetPhoto Studio, you can use WebSync to synchronously publish the album to a web server installed with JetPhoto Server Pro software.

1. Click 'Web Sync' button, or choose menu item 'Web Album'->'Web Sync' to show WebSync dialog box. In 'Server' tabbed panel, please select option 'Publish web album to JetPhoto Server Pro v2.5'.

2. Then you need enter the server URL address where you installed the JetPhoto Server Pro, and user name, password to log in your JetPhoto Server. The first account created by the server setup program is 'admin' (password is '123456'). To change this account or create new accounts, you can log in your JetPhoto Server and go to 'Users' administrative page in Website Manager.

3. Now please click button 'Synchronize Now!', the WebSync program will upload the album files to the server immediately.

4. After used WebSync, you can still continue to organize photos in the album with your JetPhoto Studio. Adds or removes photos, sorts photos and modifies descriptions or keywords. Now, uses WebSync again to update all changes to your server. In the meantime, the changed metadata and photo files will be uploaded one by one as needed.

Manual Uploading Albums
The WebSync program transfers files to the server through inside HTTP sessions, but it's also possible to upload album data files to the server manually by FTP, WebDAV or other file transfer interfaces. You should first use WebReady to export the album photos and metadata into a .data file package. And then, copy the .data file package to path jpserver/data/ on your server manually. The web album is still hidden on the server after uploading album files, you also need log in your JetPhoto Server and go to 'Table of Contents' administrative page in Website Manager, where you can remove the 'Hidden' option for the new uploaded album.

Album Short Name
Each album managed by JetPhoto has a Short Name that is an unique identifier of the album. You can edit the Short Name in Album tabbed panel in your JetPhoto Studio. If two albums with a same Short Name, JetPhoto will regard them as two different versions of one album when run WebSync. So all albums hosted in JetPhoto Server must have a Short Name different from others.

For more options while using WebSync and WebReady, please also refer to JetPhoto Studio User's Guide.

 

Managing Website

After uploading your photo album files to the server by WebSync, you can continue to use Website Manager to set web album templates, categories and listing order etc. Also can set the website profile, website appearance style, users to edit or visit web albums, keywords to search photos, categories to search albums and customized menus shown on web pages.

Website Manager Login
Website Manager is integrated with the web pages in JetPhoto Studio Pro. You can enter Website Manager pages in three ways:

In JetPhoto Studio, click 'Website Manager' button, or choose menu item 'Web Album'->'Website Manager' to show Website Manager dialog box, in which please select option 'JetPhoto Server Pro v2.5'. Enter the server URL address where you installed the JetPhoto Server Pro, and user name, password to log in the server. Then please click button 'Connect', JetPhoto Studio will launch a web browser window to show the Website Manager pages.

In JetPhoto Server Pro home page, you can find an 'Admin' link in the right side bar of the page. Click the link, an authentication page will appear in the web browser window, please enter an Administrator or Editor account to log in your JetPhoto Server Pro and show Website Manager pages.

In any web browser window, you can just go to the specific address http://<jetphoto_server_home>/web/admin/ to log in the server and use Website Manager shortly.

Once entered the Website Manager, you can click the menu links in the right side bar to get administrative pages. The user with Editor permission can use 'Table of Contents' page only, and the user with Administrator permission can use all administrative pages.

 

Site Profile
In 'Site Profile' administrative page, you can set title, description, contact, copyright and other information for your website. These fields will appear on the specified pages of the site. And need to decide the page language and encoding, also customize web page layout with some options.

Website Title - the title shown in the side bar of the home page and the title bar of the web browser window
Short Description to Introduce This Website - the text appears in right side bar of the home page, that can include HTML tags
Website Contact - the text appears at the bottom of the home page, normally can leave contact info in this field
Website Copyright - the text of the copyright information
Email
- the webmaster email, that is for sending system notifications
Site URL - the official address of this website
Site Language - the interface language of this website, default is English
Page Encoding - the page encoding of this website, normally UTF-8 is recommended
Default Album Template - the default template used for new uploaded albums

Show Categories menu on home page - an option to decide whether shows a Categories menu in the right side bar of the home page. With clicking category items in this menu, the home page will be refreshed to only list the albums belong in the selected categories. You can design the Categories menu with organizing a directory in 'Categories' administrative page and assign categories for your albums in 'Table of Contents' administrative page.

Show Calendars on home page - an option to decide whether shows a calendar in the right side bar of the home page. With the calendar, users can list albums and search photos by date. The calendar has two browsing modes: albums browsing mode and photos browsing mode. Selected the left button ( album button), all cells of the dates when you published albums are highlighted. And selected the right button ( camera button), all cells of the dates when you took photos are highlighted. Click the highlighted cell, the date-matched albums or photos will show in the page.


Show geotagged photos on map and enable KML feed - an option to decide whether enables geotagging features on the website. Once enabled this option, you will find two small icons displayed in the home page:
Click icon to show all geotagged photos in your website with a Google Map gallery.
Click icon to generate a KML file that you can download and open with Google Earth. All geotagged photos in the website are included in this KML.
And two links displayed in each album item listed in the home page:
Click link to show geotagged photos in the album with a Google Map gallery.
Click link to generate a KML file that you can download and open with Google Earth. Geotagged photos in the album are included in this KML.

Show Keywords list for photo search - an option to decide whether shows a Keywords list in the right side bar of the home page. With selecting keyword items in this list, the server will find all photos matched with the selected keywords and show photo thumbnails in the home page. You can design the Keywords list with organizing a directory in 'Keywords' administrative page.

Allow visitors to leave Comments - an option to decide whether allows website visitors to leave comments for albums. Once enabled this option, a Comments link will appear in each album item listed in the home page. You can click the link to launch a message board window where visitors can discuss each other.

Need forced user authentications while visiting homepage - an option to decide whether need show an authentication page for the user login when open the home page of your JetPhoto Server. The user who visits the server is regarded as an anonymous guest until log in the server with clicking the 'Login' or 'Admin' link in the side panel of the home page. But, if enabled this option, the anonymous guest will be unable to access any contents on the server.

 

Look and Feel
You can design the banner, logo and icon images for your website, save as JPEG, GIF or PNG files and upload them to the server. In 'Look and Feel' administrative page, can also pick the theme colors for your website.

 

Users
JetPhoto Server Pro is a multi-user content management system. A couple of photographers can publish their photo albums to one shared JetPhoto Server Pro website using different Editor user accounts. Or, you can also host and show your private photos and public photos on one shared JetPhoto Server Pro website, then you need create several Visitor user accounts for your family, friends or business partners separately.

In 'Users' administrative page, you can create user accounts to permit people to browse, publish and manage web contents on this website. The system allows three types of the users with different permissions:
Visitors can be allowed to only browse and view web contents.
Editors can be allowed to upload web albums with WebSync, and publish web pages and media files on the server.
Administrators can manage the server with full permissions.

The administrators or editors can grand visitors permission to view specific albums or other web contents on the server.

 

Categories
Categories can be used for categorizing albums, pages and files on this website. In 'Categories' administrative page, click button New Category and button New Sub-category, you can create a layered category directory, and organize categories listing in this directory freely by drag-and-drop using mouse.

Once created a directory of categories, you can assign categories for your albums on the server. Please go to 'Table of Contents' administrative page, select an item in the Table of Contents list, and click Categories bar in the right toolbox, then you can set categories for the selected album with this directory.

In the home page of this website, all categories are listed in a drop-down menu and a side menu*, you can select a category item to show the matched albums, pages and files in the home page.

* To show the Categories side menu, the option 'Show Categories menu on home page' must be enabled in 'Site Profile' administrative page.


Keywords
When organizing your photos in JetPhoto Studio on the desktop computer, you can edit keywords and descriptions for your photos. After publishing albums to the JetPhoto Server, these fields will be saved on the server for photo searching also.
Keywords can be used for tagging and searching photos stored in albums on this website. In 'Keywords' administrative page, click button New Keyword and button New Sub-keyword, you can create a layered keyword directory, and organize keywords listing in this directory freely by drag-and-drop using mouse.

This keywords directory will appear in home page of the server for photo searching*. You can click a keyword item in this list or select multiple keyword items and click Search button to find photos matched with the selected keyword(s) on the server.

* To show the Keywords list in the side bar of the home page, the option 'Show Keywords list for photo search' must be enabled in 'Site Profile' administrative page.

 

Table of Contents
Table of Contents lists all albums and other contents published on this website. Besides photo album publishing, you can also create Pages to publish your articles and upload Files to publish video or any media contents. In 'Table of Contents' administrative page, you can set web templates for your albums, set issue date, categories, allowed visitors and listing order for the albums and other contents hosted on the server.


There are 7 columns in the list of Table of Contents :

Type - is a photo album, is a video or other media file, and is a page with HTML contents.
Title - A title of the album, file or page shown on pages.
Name - A internal name of the content. For album, it's the unique name of the album (short name). For file, it's the original filename of the media file.
Date - Issue date, the default value is the time when the album, file or page was created on the server.
Editor - The user who creates the album, file or page. Normally only this user or Administrators can continue to edit this item.
Hits - Count of the times the item has been visited.
Remarks - is the item hidden in the home page, is the item only open to users who need login.


Upload Albums
If you'd like to upload a photo album to your JetPhoto Server, you need create and organize the album with JetPhoto Studio on your desktop computer and use WebSync program to upload it to the server.
After uploading with WebSync, you can find a new album item added at the first position in the Table of Contents list. Select this item in the list, and you can choose a web album template for it in General Settings toolbox on the right side of the list.

 

Upload Videos
Besides photo albums, you could also publish video files to JetPhoto Server website. Normally, the video file can be a FLV (flash video), MP4 (mpeg4 video), MOV (quicktime movie), AVI (microsoft video) or other file.
Click 'New File' button in 'Table of Contents' administrative page, and click 'Upload File...'. You can select a video file saved on your local disk to upload it to your JetPhoto Server. If your video file size is too large to upload directly*, you can also upload the file to path jpserver/media/uploaded/ on your JetPhoto Server in other ways, such as FTP. And then you click 'Import File...' button instead to import your uploaded video file into JetPhoto Server.

After file uploading, you also need to set a title, a short description and a thumbnail image for the video. Click button 'Save' to finish the publishing.
If your uploaded video is a FLV (flash video) file or a MP4 (mpeg4 video) file, the JetPhoto Server will show a Flash-video Player in the page to playback the video when the visitor open it. But if your video is a MOV, AVI or WMV file, JetPhoto Server will open it with the default control in the web browser.


You can also see an option 'For download only' in the file upload page. If you checked it, the JetPhoto Server will never playback it in the web browser, and instead ask visitors to download and save this video file before playback it. Normally, please don't use this option when you publish a FLV / MP4 video file.

* the maximum allowed direct uploading size is set in PHP configuration, see variable upload_max_filesize in file PHP.INI .

 

Upload Pictures
Besides photo albums, sometimes you may need to publish a single still picture on the JetPhoto Server.
Click 'New File' button in 'Table of Contents' administrative page, then you can upload a single JPEG file with clicking 'Upload File...' in the file upload page.
After file uploading, you also need to set a title, a short description and a thumbnail image for the picture file. Click button 'Save' to finish the publishing.
Especially, you can also publish panorama pictures in this way. If the published picture file is a panorama (the image wide is much longer than the image height*), the JetPhoto Server page will automatically present it in a special panorama image viewer with a horizontal scroll bar.

* as the program convention in JetPhoto Server, if the image height is less than 800 pixels and the image width is longer than 3 times the image height, this image will be recognized as a panorama.

 

Upload Other Files
Besides photo albums, videos and still pictures, you can also publish PDF, Word, PowerPoint and more other documents on the JetPhoto Server.
Click 'New File' button in 'Table of Contents' administrative page, and click 'Upload File...'. You can select a document file saved on your local disk to upload it to your JetPhoto Server. If your document file size is too large to upload directly*, you can also upload the file to path jpserver/media/uploaded/ on your JetPhoto Server in other ways, such as FTP. And then you click 'Import File...' button instead to import your uploaded file into JetPhoto Server.
After file uploading, you also need to set a title, a short description and a thumbnail image for the file. Click button 'Save' to finish the publishing.
You can also see an option 'For download only' in the file upload page. If you checked it, the JetPhoto Server won't present it in the web browser, and instead ask visitors to download and save this file before open it.

* the maximum allowed direct uploading size is set in PHP configuration, see variable upload_max_filesize in file PHP.INI

 

Create Pages
Besides photo albums and media files, you can also publish your articles with creating pages with some HTML contents on the server. When initializing the server, an 'About This Website' page is created automatically. Now, this page is in listed in the Table of Contents. You can select it and click button 'Edit' to modify this page, or click button 'New Page' to create a new article issued on the server. In page editor, you can enter the page source with HTML tags and a title of the page.
Once the page is saved, it will be listed in home page of the server normally. However some pages needn't be listed there, likes the 'About This Website' page that never appears in the main list of the home page, but appears in the side menu of the home page. Then you just need hide the page in Table Of Contents and make a customized menu item links to this page.

 

Edit and Delete
All published albums, files and pages are listed the Table of Contents. To edit a file or a page, you just need select an item in the list and click button 'Edit'. To delete an album, a file or a page, you need select an item in the list and click button 'Delete'.
Albums can't be edited in "Table of Contents" administrative page, instead you should use your JetPhoto Studio to edit albums and run WebSync to update changes to the server.

 

Change Listing Order
After published a new album, file or page, the new item must be listed at the top position in the Table Of Contents and shown as the first item in the home page of this website. But you can also manually change the positions of items listed in the Table of Contents.

To move one item in the list, you just need select a row in the Table Of Contents and click or button.
To move several items, you first need check the items you want to move (the checkboxes are in the first column of the table), and select a row in the Table Of Contents to mark the position all checked items will be moved to. Then click button 'Move To'.

 

More Publishing Options
A multipage toolbox is on the right side of the Table of Contents list. Some publishing options you can set for the selected item of the Table of Contents are in the toolbox. You can click three bars titled with 'General Settings', 'Categories' and 'Allowed Visitors' to switch pages in the toolbox.

Issue Date
Please select an item in the Table of Contents list, then you can set the Issue Date for the item in 'General Settings' page of the toolbox. Issue Date fields will be shown in the main list of the website home page, and will also affect RSS feed on the server.

Hidden Items
When drafts your web publishing, you can hide any albums, files or pages listed in the Table of Contents as needed. Please select an item in the list, you can check option 'Hidden' in 'General Settings' page of the toolbox to hide it. And then the item in the list will be remarked with a icon. The hidden item will never appear in the home page on the server.

Allowed Visitors
As default setting, the published albums, files and pages are open to all web visitors who needn't log in the server. However, if you would like to only allow specific visitors who need log in the server to view albums, you can complete settings as the followings:

1. First, you need create one or several user accounts with visitor permission in 'Users' administrative page.
2. Please select an item in the Table of Contents list, and check option 'Authentication' in 'General Settings' page of the toolbox. Now this item is only open to the users who need log in the server. And then the item in the list will be remarked with a icon.
3. Click 'Allowed Visitors' bar in the toolbox to show a user list, in which you can select the users who can be allowed to view this item. And the editor who create the item and administrators can always view the item.

In this way, you will manage the access control of your web albums with flexibility. You can create different user accounts for your family, friends and associates. And open specific albums to specific users.

Categories
It's easy and flexible to assign categories for the published albums, pages and files on the server, you can complete steps as the followings:

1. You need first manage your category directory in "Categories" administrative page.
2. Please select an item in 'Table of Contents' list.
3. Click 'Categories' bar in the toolbox to show a category directory, in which you can select the categories this item belongs to.


 

Customized Menus
In 'Customized Menus' administrative page, you can customize the side menus displayed in your home page. Normally links some pages there, such as 'About Us', 'Contact Us', etc. Any menu item can be defined to be a hyper-link to a page, album, file, category or an external URL.

 

Server File Directories

If you are a web designer or developer, to understand the server file system structure will be useful to help you to build and customize your website using JetPhoto Server. There are six folders store all photo album data, uploaded media files, web album templates, website configurations and other necessary web pages in the file directory of JetPhoto Server.


jpserver ------- system ------- frameworks   1 
            |              |--- components   2
            |              |--- resources    3
            |              |--- services     4
            |              |--- websync      5
            |              \--- gmap         6
            |
            |--- data --------{ *.data       7
            | 
            |--- view --------{ *.view       8
            | 
            |--- site --------- config       9
            |              \--- images       10
            |
            |--- media -------- files        11
            |              |--- uploaded     12
            |              \--- tmp          13
            | 
            |--- web ---------- default      14
                        |------ admin        15
                        |------ public       16
                        \------ init_server  17

 

1. PHP files that contains required functions and classes.
2. Reusable web page components, such as Flash controls, JavaScript/CSS files
3. Localizable string files
4. Web service scripts
5. WebSync interface scripts
6. Google map gallery files
7. Album data file packages ( .data folder packages photo files in an album )
8. Web album templates ( .view folder packages template pages a web gallery requires )
9. Site system configuration ( MySQL connection and Google Maps settings )
10. Site banner and logo files
11. Video or other media files that are published on server
12. A folder to save uploaded media files for importing
13. Temporary files for internal data exchanging
14. Default home pages
15. Website Manager pages
16. Public module pages
17. Server setup pages

As a web designer or webmaster, you can establish a customized interface with your own special design, only to do is following the JetPhoto Server's structure. For more information to customize your JetPhoto Server, please refer to our Developer's website.

 

 

JetPhoto Software
Copyright © 2004-2010 Atomix Technologies Limited All Rights Reserved