WELCOME TO IMAGEISLAND - VERSION 3.10 --------------------------------------------------------------------- ImageIsland - An Image Management Web Application created by GiantIsland LLC and sold through GiantIsland.com. Copyright (C) 2009 GiantIsland LLC --------------------------------------------------------------------- This file contains installation, server requirements, help, support, and licensing information for your ImageIsland web site software. At GiantIsland.com, we are proud to bring you ImageIsland 3.1. This web-based software allows you to upload, edit, delete, and manage your images and photos online using your current web site, as well as let others users manage their photos as well, all from your domain! With ImageIsland, you can now upload and manage all your images on your own web site. Simply download the software files, upload them to a suitable web server, and link to them in a browser to begin managing your own images online. INSTALLATION - Simple Instructions for Installing ImageIsland --------------------------------------------------------------------- http://www.giantisland.com/Support/Support/Installation.aspx --------------------------------------------------------------------- The following is an outline of the steps needed to install our products on your web site and server and get your web site installation up and running fast. The following is a brief outline of what you will need to do to install the web software. Please read further for more detailed information, or visit our web site at http://www.giantisland.com: 1. First, verify your web site and server meets all server installation requirements (see below). 2. Download the software to your computer and uncompress to a single folder using your PC (or using Winzip or StuffIt). 3. FTP the product folder to your web site and server. 4. Verify that both ASP 3.0 and ASP.NET 1.1 are enabled on your web site and server. 5. After installing all files, make sure all folders have the correct read/write user permissions on the server (see below). 6. Test the product live on the Web by typing your url, plus the product folder name. If everything has been uploaded correctly, installation is complete, and your server has all the required settings, then you should be able to begin uploading files and using the product immediately. Be sure to read the Help pages in each module for more detailed information on installing and using your product. DETAILED SERVER REQUIREMENTS --------------------------------------------------------------------- Requirements - http://www.giantisland.com/Support/Requirements.aspx FAQ's/Troubleshooting - http://www.giantisland.com/Support/FAQ.aspx --------------------------------------------------------------------- The following is a detailed summary of the steps needed to install our products on your web site and server and get your web site installation up and running fast. This information includes the server requirements: 1. Windows Computer - When installing, you will be required to download our software, after purchase, to a Windows computer or PC. The files are stored "compressed" using Windows 2000,XP, or Vista. So, we prefer you use a Windows computer when downloading, so you can easily uncompress the downloaded software file. If you do not, you may still uncompress our files on older Windows machines if you have a copy of WinZip Software. Either Windows XP/Vista or a copy of WinZip software will allow you to extract the files. (Note: Apple Macintosh computer users may try "StuffIt" to uncompress the product folder to their desktops). 2. Web Site - You are required to have a web site on the Web in order to use our software. There are many affordable and even free web site hosting companies online you can use, if you do not have a web site, or your web site will not support our software. We recommend you consider buying a very affordable Microsoft Windows hosted web site for your software, if you do not have one, as well as web domain. Are partner, www.GoDaddy.com, fully supports our products. You may get a Windows web site for free or a very small fee when you buy a domain! Because our software supports traditional features inside a typical IIs Windows web server environment, once you get your web site running, it's just a matter of uploading our software to your web site in order to get started! 3. Windows Web Site Server - Requires that your web site server must be a Microsoft Windows web server (IIs). Any of the following will support the software: -Windows NT Server (some limitations may apply on older versions of NT) -Windows Server 2000 (highly recommended) -Windows Server 2003 (highly recommended) -Some additional Microsoft Server packages may also run the site. Please check with your Host Provider if they are running any of these servers. In any case, they must run IIs version 4, 5 or 6. 4. Windows Web Site Settings - In addition, the Windows Web Server requirements include setup with the following features. These must be setup in order to run successfully on the server: -ASP Classic (3.0) must be setup to run on the web server and site -ASP.NET 1.1 must be setup to run on the web server and site -MSXML installed on the server (by default, is on almost all Windows servers - installed with Internet Explorer) -Because our products read and write files to the web server, they must have "read/write/delete/modify" permissions set on the root folder of the web site for the "IUSR_" and "ASP_NET"/"NETWORK_SERVICES" accounts. (Note: The IUSR controls permissions for the ASP and MSXML write access identities. The ASP_NET and NETWORK_SERVICES affect ASP.NET process accounts. The IUSR can be applied directly to the web product folder itself, but the ASP.NET permission must be applied from the web root. Both permissions must be set to allow inheritance and propogate on down through all folders and files contained inside the web site, especially the "web product" folders and files (example: the "ImageIsland" folder on the web server) Keep in mind, all web server requirements are the sole responsibility of your Host Provider, who must support and install all these technologies on the web server that supports your hosted web site. In all cases, your host provider can easily check and verify these technologies are present, or simply add them free of charge, as they are all default properties of IIs on most Windows web servers. DETAILED INSTALLATION - Detailed Instructions for Installing ImageIsland --------------------------------------------------------------------- Installation - http://www.giantisland.com/Support/Installation.aspx FAQ's/Troubleshooting - http://www.giantisland.com/Support/FAQ.aspx --------------------------------------------------------------------- Once you met the requirements above, to install the web product, simply download the compressed file to your Windows PC. Extract or uncompress the file by double-clicking the file on your desktop and dragging the web product folder to your desktop. You should see a single folder of files. That folder is the complete web product that you will now upload to your web site! To upload this folder and all its files, you must have access to your web site using FTP (File Transfer Protocol) software or other upload process. We recommmend you have FTP access using either FTP Software (which is free and can be downloaded here: www.download.com) or your web browser. Your ISP or Host Provider will have information on how to upload files to your web site. In most cases they will have sent you information on how to connect to your web site and their servers using FTP. Once you have connected to your web site using FTP, find a suitable web folder under the web root of your web site. Our web Products are designed to work under any folder or subfolder foound in your web site. The software will intellgently figure out where its at and set its file paths and other variables the first time you surf to the product using your browser. Once you have found the folder inside your web site where you want to upload the product, begin uploading its folder to that location. The size of our products is relatively small, and in some cases less that 500 kilobytes. But because some folders, like skins, have so many files, it may take a while to upload. Please be patient and let your FTP software upload all files under the web product root folder. That's it! Once the complete web product folder of files has been uploaded into your web site domain, simply link to the product folder. That would be wherever you uploaded your folder. (example: http://yourwebsitedomain.com/yoursubfolder/imageisland/). When you link to the root product folder the first time, you may have a short wait (few seconds) while it builds variables needed to run. Once thats complete, and assuming you have set up all the permissions and requirements, you should see the web product homepage. You will know its an "Island" product as you will always see the twoo major dropdown menus at the top left of the interface. (*Note: If you have any problems viewing your software at this stage, please go back and read our "Requirements" area above and make sure you have set up all the features and services required. If your site is hosted and controlled by an ISP or Host Provider company, email them and request that all requirements listed in our FAQ section are fulfilled. We also will be adding a "Support" section soon to our site and troubleshooting details area as well to assist you!) ---------------------------------------------------------------------- ADDITIONAL SERVER SETUP & CONFIGURATION INFORMATION ---------------------------------------------------------------------- WINDOWS WEB SERVER REQUIRED: ImageIsland will only run on a Windows Server (Internet Information Services - IIs). Many ISP's support Windows. Please ask your ISP what kind of box or server your web site is on and if it would also run on Windows. Some may even move your site for free from a Linux or other box to a Windows box. But you must have your site running on a Windows Server. You can also buy hosting or find free hosting and post ImageIsland there as well, if you like. We have hosting partners listed on our web site, which we recommend for easy setup of our products: www.giantisland.com. Even though ImageIsland is built on Active Server Pages(ASP 3.0), which will run on some Linux/Apache boxes, it also needs ASP.NET 1.1 (thumbnail and rotate tools) and MSXML (database processing). So, Windows is preferred. It can be run on Windows NT, but make sure your server supports the right version of VBScript and MSXML, both of which should be updated if Internet Explorer 5.5 has been installed on the server. It is better if ImageIsland is installed on Windows 2000 Server or Windows 2003 Server. It may also run on other Windows servers, like BizTalk, Commerce Server, etc. Check your specific server or ISP and ask them what they support. Again, on Windows, most systems already have ASP, ASP.NET 1.1, and a flavor of MSXML already installed. But if they dont, please ask you ISP or host provider to verify. (The web site does have some troublsehooting script you can uncomment and run inside the "System/SystemSettings.asp" page to detect what version of VBScript and MSXML it supports). It's very important that all three of these services and permissions are running on the server before the application will run correctly. ASP CLASSIC AND ASP.NET 1.1 REQUIRED: As mentioned, you must have ASP (Classic 3.0) AND ASP.NET 1.1 running on your Windows IIs server. In Windows 2000 Server, there are no special setup issues. But on Windows 2003 Server, you have to make sure you have enabled both ASP and ASP.NET 1.1 on the web server in IIs to use them. Most ISP's have both working by default, but some turn off these items for security reasons, when not used. If the site does not appear to run, or generates errors (bottom of the page), have them check that ASP (Classic - 3.0) is enabled. If the thumbnail or rotate areas wont run, or you get a special yellow and white exception screen in your browser when you upload image files or rotate in the ImageManager Module, then you need to enable ASP.NET 1.1 on the box in IIs. ASP.NET 2.0 and 3.0 may be sufficient, if 1.1 is turned off. There also may be a permission problem (see below) for either ASP.NET or the anonymous IUSR web guest account (see below), if files are not uploading, or rotation generates an error. You will see these errors logged at the very bottom of your ImageIsland pages when errors occur. PERMISSIONS: READ/WRITE ACCESS MUST BE SETUP ON THE WEB SERVER for ImageIsland to run correctly! In order for ImageIsland to write to the web server, you must give the IUSR (anonymous) and ASP.NET process identities full read/write permissions on the server. These permission must be set so that they will successfully "propogate" down to the "ImageIsland" folder and all its sub files and folders. If you are using a server someone else hosts for you, do not worry. This is usually done for you and often must be done by your ISP. Please request this setup from your ISP provider if you note any problems uploading files, submitting changes, or writing files in the web application. ADDITIONAL SERVER PERMISSION INFORMATION ---------------------------------------------------------------------- If you need to know how folder permissions are done on the web server, please read below, for reference: To setup physical folder permissions for ImageIsland, you must go onto the IIs web server, right click the folder that is the root of your web site, and choose properties. In this dialog box click the security tab, and then advanced button. Make sure both the "IUSR" and "ASP_NET" (NETWORK_SERVICES usually, on Windows 2003 servers) identity accounts are added in the list, and change the permissions for both accounts so that they both have read and write permissions enabled. When you have done that, make sure you click the check box to "Replace permission entries on all child objects..." and click the "Apply" button. This will force inheritance on all child folders and files under your web site root folder and affect the ImageIsland folder and its ASP and ASP.NET file permissions. This makes sure the engines and service accounts that control ASP, ASP.NET and MSXML have access to manipulate files and write them to the server folders as needed. In general, you can apply IUSR read/write permissions on the ImageIsland folder on down. But the ASP.NET account must have permissions beginning at the web root of the web application. Because ImageIsland does run a limited number of ASP.NET files and processes, it must have those permissions set from the web root of the web site, and propogated down through the ImageIsland folder itself. So make sure your web site has read access for the ASP.NET account from the webroot of your site on down to the ImageIsland folder itself as well. (Keep in mind, these permissions apply to physical folders on the actual web server, not virtual folders controlled by IIs). Always apply permissions to physical folders on the server. Note: At this time, we do not use "impersonation" in the .NET application pages. This may be setup in individual Modules inside ImageIsland using the web.config file, if needed. That can be modified using a text editor. ---------------------------------------------------------------------- HELP AND SUPPORT ---------------------------------------------------------------------- When accessing the web product using your browser, you may find you need a little help understanding what each section of the web product does. If you do, we have built a special help section for each module in the product. Every "Module" accessed via the dropdown menu in the upper left corner of the screen, comes with its own Help system or web page with full descriptions of what each module does in the system. This includes a single page with details about the module and may be accessed by clicking the "?" icon in the upper right corner of the module interface. These pages go into detail how each area of the modules works, and will help explain how to use each area, once you get your web product up and running correctly on the server. For additional support information, please visit our Support pages located at our web site: http://www.giantisland.com/Support/ ---------------------------------------------------------------------- FAQ's ---------------------------------------------------------------------- For more detailed information concerning installation, requirements, or troubleshooting, please visit our FAQ section located at our web site: http://www.giantisland.com/Support/FAQ.aspx ---------------------------------------------------------------------- GIANTISLAND LLC SOFTWARE LICENSE AGREEMENT ---------------------------------------------------------------------- You may use this software according to the software license agreement that comes with this program. By purchasing, downloading, installing, and using this software, you agree to abide by the terms of this agreement. For more information on your software license agreement, please read the software license agreement found inside the root folder of this product. This license must remain intact inside all copies of this application. For additional licensing information, please visit our License pages located at our web site: http://www.giantisland.com/Support/Licensing.aspx ---------------------------------------------------------------------- COPYRIGHT INFORMATION ---------------------------------------------------------------------- Our software license agreement describes, in full, your responsibility and rights as far as uploading and distributing content using our software. However, please be aware that the almost all content created in the United States, including music, video, and digital content (even going back prior to 1922) is now protected by copyright laws, as well as international treaties. This means that uploading, downloading, playback, and even distribution of copyrighted materials is illegal in the US and many countries around the world. Be sure: A. you are either the original creator of the work(s) you are posting online (i.e. the copyright holder), B. you have full rights, or have acquired rights from the copyright holder, to hear, view, and distribute such content online, C. or content you are using has been placed in the "public domain" (http://creativecommons.org/licenses/publicdomain/). Be sure, before you or your users post images, video, audio, or other items online, that you are aware of the owner/holder of that copyrighted material. In some cases, you may violate such rights, and may be requested (or your ISP may be contacted) to remove such materials and avoid legal problems (i.e. Digital Millennium Copyright Act of 1998). In such cases, it is your full responsibility to resolve such issues and address them in a legal fashion. GiantIsland LLC and its vendors and web sites are not responsible for such violations or liable for any issues related to illegal posting of copyrighted materials using our software. By agreeing to the terms of your software license with us, you elect to release GiantIsland LLC and GiantIsland.com from all such liabilities and responsibilities. We provide this information here for your understanding, and protection when using our web software. For additional copyright information, please visit our License pages located at our web site: http://www.giantisland.com/Support/Licensing.aspx ---------------------------------------------------------------------- UPDATED VERSION INFO - POST VERSION 3.10 ----------------------------------------------------------------------- 1. fixed folder tree where long folder names now always appear on 1 line. 2. added web.config file and security piece to all Module Data Table folders 3. fixed delete process so only id is used and file paths do not cause JavaScript Delete method issue 4. Updated Photobox1 templates so image source loads first before resizing image 5. fixed image deletion occuring in the edit section of the ImageManager 6. fixed all group galleries - now draw thumbnail images faster for cases where there are very large libraries of images in the system 7. Added iPhone(TM) viewport metatag for easier access via your iPhone. 8. Fixed small design bug in Group Gallery page. Now, default template pages float in blocks and do not overflow design. 9.Added sample iframe gallery so users can paste any WebPage into their existing website. 10. Added new ImageWebPage Module sorting feature. Now, all images in all galleries can be set in terms of their order in the assignment page and the gallery pages. 11. Fixed bug in ImageWebPages where no images appear in the assignment area the first time you come to the page. After clicking "folder" in the dropdown, it resolves itself. With the fix, users see images prior to that event, and for all folders. 12. Fixed small issue in the ImageWebPage Module where clicking a paging number in the assigned images box, gets stored as the same page of images in the Gallery pages. So when you leave the assignment area, then test your gallery, you would be taken to whatever page of images you last viewed and it appears the order in your gallery is not correct. Added unique paged sessions id's for all pages in this module. 13. Fixed two sorting issues in ImageWebpage Module. Whenever an image is deleted in the ImageManager, now we also delete all instances of the image in the FileToPage database in the ImageWebPages Module. This fixes bug where a deleted image assigned to a gallery creates a blank page in gallery. This affected all template pages, the manager delete process page and the assign images web page. We also addressed the issue where the MemeoryManager in the ImageWebPages module was resorting an already sorted array passed into it, causing the ordernumber value in the FileToPage database to be resorted when an image is reordered in the assign file page. This now does not resort but retains ordernumber order in gallery and assign file page. 14. Fixed issue in ImageWebPage "slideshow2_black", where path is wrong. 15. Updated ImageWebPage Module with PhotoBox1 revision. Now, the thumbs are cropped as squares rather than stretched, and they use the thumbnail, not the full size image as before. *If you find any bugs in the web product, please alert us via email at: support@giantisland.com ----------------------------------------------------------------------- Thanks again for purchasing software from GiantIsland.com! (1/1/2009) - GiantIsland.com and GiantIsland LLC