non

Since the manual has increased in size, I've added a quick install overview for the component. For more information, you'll need to read the large chapters. It looks quite a job, viewing this big manual, but is is as simple as every other Joomla! Component. This is a small overview over a safe installation/update. Good luck, and enjoy the gallery! · Verify if your host has the requirements (see 1.4) · Download the latest release (see 2.3) · When updating or reinstalling, backup your /img, /xml and /config folders, so you can restore it later without uploading all your pics again (see 2.4) · Make a safety backup of your Joomla! site (see 2.8) · If updating, replace all files from the updatepack (check readme.txt in package). When reinstalling, then uninstall the old component (see 2.7) and install the full component again using the Joomla! backend installer (see 2.5) · Create a component menu link (see 2.11) · Check frontend functionality with the default images from installation · Change default password (see 2.5) · Change configuration (see 3.4) · Upload your images, or restore previous gallery contents (see 2.8) 2.2 RC3 <-> RC4 <-> 4.6.2 <-> 4.6.3 RC3 uses Joomla! authentication to access the manager. In RC4 you’ll need to login in the manager with a password (=manager) after logging into the back-end. But in RC4 you can login into the manager without accessing the back-end at /components/com_expose/expose/manager/manager.html, so, everyone who has the password can manage the photos from there. RC3 front-end doesn’t use the DOMXML library. RC4 does use it to get the gallery size settings. In RC4, the interface language is now specified in a FlashVars parameter named language in the expose.html.php file instead of the Language parameter in config.xml, which was removed. In 4.6.2, the language can be set in the configuration again. The magnifying glass button is removed in RC4 and the medium-sized image was made clickable instead, making it possible to popup a 'large image' or redirect to a specified URL. 4.6.3 has been created for J!1.0 and J1.5 compatibility in one package. The flash is more closely integrated in the J! Core, iframes are removed, translation functions added (auto language selection), and a nicer grouped configuration section. For a detailed changelog, you should read the changelog.txt file appended in the package, or installed at /components/com_expose/changelog.txt 9 www.gotgtek.net User, Administrator & First problem solving manual Last updated: 2/05/2008 v1.6 Expose RC3 – 4.6.3 for Joomla! 2.3 Downloading The latest Expose packages are available as zip archives on the JoomlaCode site at url http://joomlacode.org/gf/project/expose 2.4 Update and re-install Before installing a new version of Expose, make a backup (see 2.8) to preserve the actual contents. Then update all files from the update pack (read the readme.txt in the package for extra notes). You could also uninstall the old version and install the new one. Then try the functions of the new version before restoring the previous contents of the gallery. 2.5 Install Before applying (big) changes to your site, always make a backup (see 2.8). For Joomla! you need to have a FTP-copy and an sql-dump of your database to restore it in times of trouble. If you want to be really sure, try this copy out from time to time on a testserver to verify if the backup isn’t corrupt… Expose is installed using the Joomla! component installer. Login to the administrative back-end of your Joomla! installation. From the main toolbar, select INSTALLERS > COMPONENTS. Browse to the com_expsose.zip file you downloaded above and click the UPLOAD FILE & INSTALL button. If everything goes well, you will see the Expose ‘Upload component - Success’ screen. Click CONTINUE to complete the installation. Now, continue by adding a menu to the Expose component and test the default installation without changing any settings. If the gallery shows in the front-end, the first thing you need to change is the default password, which is manager. Log into the back-end, select COMPONENTS > EXPOSE > MANAGE ALBUMS and click on the CHANGE PASSWORD button. Enter the new password. Now use your new one to log in. Change the configuration properties as your taste to fit the template design, and finally start uploading your own photos. Have fun! (but keep reading this manual for further information!) 10 www.gotgtek.net User, Administrator & First problem solving manual Last updated: 2/05/2008 v1.6 Expose RC3 – 4.6.3 for Joomla! 2.6 File & directory permissions Depending on the changes you're gonna apply, some files or directories have to be writable by the PHP engine. The package contains a little check script to verify this for you. Just run the 'Check System' in the Backend Expose component menu (since 4.6.2, older versions need to run /components/com_expose/expose/manager/check_system.php) and see the result of it. If errors occur, you need to change the config of your server (most probably ask your host). If warnings occur, you need to verify the pointed files / paths permissions (make them writable). To maintain the maximum security, only change these file / directory permissions: TIP: Do you need to set the permissions to 777 to make your directories and files writable? Then check this article at http://help.joomla.org/component/option,com_easyfaq/task,view/id,99/Itemid, 268/ on how you need to change some serversettings. 2.6.1 Changing settings Make sure following files are writable when changing its settings. After changing, it's advisable to chmod these files back to 644. Configuration settings: /components/com_expose/expose/config/config.xml Lettertypes: /components/com_expose/expose/config/strings.xml Password: /components/com_expose/expose/manager/amfphp/extra/passhash.inc.php Manager properties: /components/com_expose/expose/manager/amfphp/extra/settings.xml You can always edit the files yourselves, if using the configuration interface causes problems, using JoomXplorer or an other component. 2.6.2 Changing Gallery contents Make following directories and files writable when changing the contents of the gallery: Images: /components/com_expose/expose/img/ Contents: /components/com_expose/expose/xml 11 www.gotgtek.net User, Administrator & First problem solving manual Last updated: 2/05/2008 v1.6 Expose RC3 – 4.6.3 for Joomla! 2.7 Uninstall Before updating, you need to uninstall the actual installation of the component. Having trouble with the component? Let us know by posting a topic on the forum at http://www.gotgtek.net/forum. Sure to uninstall? Always make a backup and use the uninstaller in the Joomla! backend to remove the component. Go to the INSTALLER > COMPONENTS section, select Expose from the list and hit the UNINSTALL button. It’s gone. TIP: If something goes wrong during uninstall, then try again. If the component isn't listed anymore, check and remove any existing traces of the component: · Remove /components/com_expose directory · Remove /administrator/components/com_expose directory J! 1.5.x also adds two language files to your site: · Remove /administrator/language/xx-XX/xx-XX.com_expose.ini file · Remove /administrator/language/xx-XX/xx-XX.com_expose.menu.ini file 2.8 Backup Expose doesn’t use the Joomla! database to preserve its information (except menu and component links). All settings, data, movies and photos are stored in the /components/com_expose/expose/xm l and /img directory. You only need to backup these two and your gallery can be restored at any time. It could be usefull to write all your settings (configuration and picture sizes) down too, so you can restore them easily later, together with a copy of the /config folder. After reinstalling the gallery and testing it without modifying the default installation, you can restore the /img and /xml folders to restore your previous content again. The structure of some /config files has been changed in 4.6.3 release. Be sure NOT to restore them from an earlier version! 2.9 Activating missing libs Like mentioned in 1.4 your (hosts) server needs some extensions to be activated. Most of them only need to be uncommented in the php.ini configuration file, but mostly they can only be changed by your host himselve, so you'll probably will have to mail him to change this setting. After changing the configuration, you need to restart the webserver service to apply the new settings. 12 www.gotgtek.net User, Administrator & First problem solving manual Last updated: 2/05/2008 v1.6 Expose RC3 – 4.6.3 for Joomla! 2.9.1 Check current PHP settings If you want to know your current configuration of your PHP engine, the Joomla! back-end SYSTEM > SYSTEM INFO > PHP INFO, gives you a full overview of all settings and extensions. You can also become the same overview if you create a small script with this line in it: Save it e.g. as phpconfig.php and place it on your server. Then call this file with a browser. 2.9.2 DOM or DOMXML extension The DOM extension allows you to operate on XML documents through the DOM API with PHP 5. For PHP v4 you need to use the DOMXML extension. By default, this library should be installed and activated. See http://php.net/domxml for more information about this plugin. Since PHP v5, the XML lib functions are stored in the DOM extension. There is no installation needed to use these functions anymore; they are part of the PHP core now. More information about this extension can be found at http://php.net/dom. 2.9.3 GD extension PHP can also be used to create and manipulate image files in a variety of different image formats, including gif, png, jpg, wbmp, and xpm. Even more convenient, PHP can output image streams directly to a browser. The GD library (available at http://www.libgd.org) and PHP engine may also require other libraries, depending on which image formats you want to work with (e.g. for reading meta data of pictures you need the exif extension). Since PHP 4.3 there is a bundled version of the GD lib. More information at http://php.net/gd. For linux, to enable GD-support configure PHP --with-gd[=DIR], where DIR is the GD base install directory. To use the recommended bundled version of the GD library (which was first bundled in PHP 4.3.0), use the configure option --with-gd. GD library requires libpng™ and libjpeg™ to compile. To disable GD support in PHP add --without-gd to your configure line. In Windows®, you'll include the GD2 DLL php_gd2.dll as an extension in php.ini. The line extension=php_gd2.dll should already be in your php.ini, you only need to uncomment it (remove the ; at front of the line) to activate it. Restart your webserver service after changing to apply the new setting. 13 www.gotgtek.net User, Administrator & First problem solving manual Last updated: 2/05/2008 v1.6 Expose RC3 – 4.6.3 for Joomla! 2.9.4 Freetype subextension To embed copyright text on your uploaded images, you need the Freetype font libraries. Like you can see on this picture, Freetype is listed as a component in the GD extension section. In Linux, to enable support for FreeType 2 add –with-freetypedir= DIR to your configure line. 2.9.5 ICONV extension With this module, you can turn a string represented by a local character set into the one represented by another character set, which may be the Unicode character set. In order to enable this module on a Windows® environment, you need to put a DLL file named iconv.dll or iconv-1.3.dll (prior to 4.2.1) which is bundled with the PHP/Win32 binary package into a directory specified by the PATH environment variable or one of the system directories of your Windows® installation. This module is part of PHP as of PHP 5 thus iconv.dll and php_iconv.dll is not needed anymore. More information at http://www.php.net/iconv. 2.10Security issues Some of the users seem to neglect the security issues for the Expose component (and others plugins for Joomla!) after installation (usually by not reading the documentary). A quick overview to tighten it: · Before updating, always make a backup (see 2.8) · Before installing, check if the required settings and libraries are installed (see 1.4) · After installation, change the Manager’s default password (see 3.2). · On version 4.6.2 or earlier, remove the /components/com_expose/expose/manager/check_system.php or any other file (e.g. phpinfo.php) giving info about your server’s config. It gives hackers all info to access your server. · Changing .htaccess file can cause serious security issues! Be aware of it! 14 www.gotgtek.net User, Administrator & First problem solving manual Last updated: 2/05/2008 v1.6 Expose RC3 – 4.6.3 for Joomla! · Never leave php files chmodded to 777. This enables edition of the file by all visitors (...and hackers). The Joomla! standard chmod of 466 for files and 755 for directories should be just fine if all requirements (see 1.4) are fulfilled. · General Joomla! Security overview can be found on http://forum.joomla.org/index.php/topic,81058.0.html · Register yourselves at JoomlaCode.org, and activate 'monitoring' on the Expose project page. This will send you a release message by mail. 2.11Displaying in front-end Expose is added to the front-end of your Joomla! installation by simply adding a 'Component' type menu item and pointing it to the Expose component. Login to the administrative back-end of your Joomla! installation. From the main toolbar, select the menu to which you wish to add your gallery link. Select NEW from the Menu Manager page that is currently displayed. On the ‘New Menu Item’ page, select COMPONENT, and then choose EXPOSE from the list of installed components. To view your gallery, browse to the front-end of your site and select the new menu item you created. The sample albums should be visible. 15 www.gotgtek.net User, Administrator