Gallery 2 FAQ [Work in Progress]

Makc666
Makc666's picture

Joined: 2003-12-26
Posts: 78
Posted: Tue, 2004-12-21 05:02

mindless, please update mine...

 
mindless
mindless's picture

Joined: 2004-01-04
Posts: 8601
Posted: Wed, 2004-12-22 16:05

Added:

Quote:
(14-Dec for partial fix -- will allow you to install -- 21-Dec for full fix -- will also allow links to work).

Q: I'm trying the User Albums module with G2 Alpha-4 and it does nothing.. what's wrong?
A: There was a bug in alpha-4 with that module.. it does in fact do nothing.. update to a recent snapshot and it will work again.

Makc666, what are you asking for? Adding that one sentence about where the derivative images are stored on the filesystem?

 
mindless
mindless's picture

Joined: 2004-01-04
Posts: 8601
Posted: Mon, 2005-01-17 18:58

did some cleanup of old information, made some updates, and added one entry..

changed:

Quote:
Q: How do I update my CVS version of G2 without losing my images?
A: If you read the above question, you know there is a reason not to use G2 as your photo gallery yet. This is why. Currently, when you "update" your version of G2 it may require that you DROP the DB and clear the data dir. This means you lose all your hard earned $$$! (well, pictures actually). You can update cvs, and if everything appears to work... don't worry. If things appear broken, you should zap your gallery and start over.

Update: G2A4 Includes support for upgrading between releases of G2. It may not work backwards from G2A4 (A3, A2, A1), but it will work going forward. Of course, you may still end up having to zap your db and /g2data dir.

to:

Quote:
Q: How do I update my CVS version of G2 without losing my images?
A: See /gallery2/README.html for general instructions. Starting with alpha-4 upgrades are supported (you may not be able to upgrade from previous alphas however).. the basic process is to overwrite the codebase with the new code, then visit your gallery. You'll automatically see the upgrader if a core upgrade is required. If you don't see the upgrader then login as an administrator and visit Site Admin / Modules to see if any other modules need to be upgraded.

removed:

Quote:
Q: Why do I have to delete my database and directory?
A: During the alpha, the developers want to be able to change the directory and/or database structure without having to worry about how the old code will deal with things. This means that its possible your "old" database or files will not be compatible with your "updated" G2. The reason for this is pretty simple: If they don't have to worry about this, they have far more time to code. Do you want them spending precious development time figuring out how to import old G2 data or making G2 better and better? :)

Update: G2A4 introduced the ability to upgrade from one version to the next on a moving forward basis. By that, I mean it can update anything after G2A4 but may have issues doing it for releases before G2A4.

Q: Are there plans to allow upgrading G2 to newer versions without loss of data?
A: YES! This is just an alpha thing to speed development. I would guess that near the end of alpha or beginning of beta, the db/dir will be stable enough for development of these tools. Update: This could be present in the next alpha!

Update: The ability to upgrade G2 between versions has been added in G2A4. It is possible that the upgrade script will NOT work on previous versions of gallery, but it should work from G2A4 forward.

changed:

Quote:
Q: I customized a *.tpl.local file, but then removed it... but the customization is still showing up. Did I do something wrong?
A: If you remove a *.tpl.local file it won't switch back to the *.tpl file due to smarty caching. You can get it to switch back to *.tpl by clearing the smarty cache manually on the filesystem, using FlushTemplates test found in the /lib/tools/test/ page or by doing 'touch filename.tpl' which causes the last change time to update.

to:

Quote:
Q: I customized a *.tpl file, but then removed it... but the customization is still showing up. Did I do something wrong?
A: If you remove a local/*.tpl or *.tpl.local file it won't switch back to the *.tpl file due to smarty caching. You can get it to switch back to *.tpl by clearing the smarty cache manually on the filesystem, using FlushTemplates test found in the /lib/tools/test/ page or by doing 'touch filename.tpl' which causes the last change time to update.

changed:

Quote:
Q: I really wish this feature were part of G2, is it planned? (there are surely ones I am missing?)
A: It is possible that it is planned. A few things I have heard mentioned include plans for mirroring, load balancing, upgrading from previous versions of G2...

to:

Quote:
Q: I really wish this feature were part of G2, is it planned?
A: It is possible that it is planned. See this list of requested features. Also see the feature request section on sourceforge. If you don't see your idea listed you can file a feature request on sourceforge and/or start a discussion about your idea in the G2 Development forum. If you do see your idea listed it may still be a long time before it gets implemented so if you or someone you know can help out with development, please do!

changed:

Quote:
Q: Is the slideshow broken? Should the display of images/thumbs be messed up?
A: Its possible that the "IE7" code they are testing is messing something up for you. Try copying the "/templates/global.tpl" -> "/templates/global.tpl.local" and then deleting or commenting out the IE7 specific code. I believe it is the section below, so you know.

    {* We're experimenting with Dean Edward's IE7 patch:  http://dean.edwards.na
me/IE7 *}
    <!-- compliance patch for microsoft browsers -->
    <!--[if lt IE 7]>
    <script src="{g->url href="lib/IE7/ie7-standard.js"}" type="text/javascript"></script>
    <script src="{g->url href="lib/IE7/ie7-css3.js"}" type="text/javascript"></script>
    <script src="{g->url href="lib/IE7/ie7-css-strict.js"}" type="text/javascript"></script>
    <![endif]-->


Update: The IE7 code has been removed, but fixes and optomizations for IE6 have not yet been done. This means that some things may look wonkey, laid out quite oddly... but it is being worked on. You should be able to figure out if it is an IE6 issue by viewing your site in something like Mozilla Firefox. If it works in Firefox but not IE6, its due to the code not yet being optomized for IE6.

to:

Quote:
Q: Something looks funny in IE6?
A: We recently removed a standards compliance patch for IE (caused more problems than it solved) and may not have resolved all rendering issues in IE. You should be able to figure out if it is an IE6 issue by viewing your site in something like Mozilla Firefox. If it works in Firefox but not IE6, its due to the code not yet being optimized for IE6.

changed:

Quote:
Contact us in the forum if you are having problems or need help.

to:

Quote:
Contact us in the G2 Development forum if you are having problems or need help.

changed:

Quote:
Q: Once I have G2, where do I begin?
A: The BEST place to start is /gallery2/README.html. If you wish to jump ahead and start the install, you can point your browser at /gallery2/install/ instead. If its your first time, you WILL need to visit the README.html in order to get your MySQL DB setup.

to:

Quote:
Q: Once I have G2, where do I begin?
A: The BEST place to start is /gallery2/README.html. If you wish to jump ahead and start the install, you can point your browser at /gallery2/install/ instead. If it's your first time, you will need to visit the README.html in order to find database setup instructions.

added:

Quote:
Q: I am having trouble configuring a graphics toolkit (ImageMagick, NetPBM or ffmpeg). Help?
A: First- when the configuration asks for the path it is not asking for the path to the gallery2 module (like gallery2/modules/imagemagick). These directories are G2's interfaces to these programs and not the programs themselves. You need to find or install the binaries on your system, make sure they are executable, and enter the appropriate path in the configuration.

 
mindless
mindless's picture

Joined: 2004-01-04
Posts: 8601
Posted: Tue, 2005-01-18 17:24

added:

Quote:
Q: How can I integrate G2 into my website?
A: For basic integration see templates/global.tpl included with G2. Here you can add any html for your website header/sidebar/footer, etc. To include php code in this file wrap the code in {php} and {/php} tags (see http://smarty.php.net/). For application level integration (embedded G2) see the Embedding & Integration topic in the G2 Development forum and docs/EMBEDDING included with G2.

 
mindless
mindless's picture

Joined: 2004-01-04
Posts: 8601
Posted: Mon, 2005-01-24 17:23

I added a list of the questions at the top... fryfrog, any progress on a KB app for the FAQ?

 
mindless
mindless's picture

Joined: 2004-01-04
Posts: 8601
Posted: Sat, 2005-02-05 00:25

Added:

Quote:
Q: Why can't I install with MySQL 4.1 or higher?
A: If the installer gives you an error like "Client does not support authentication protocol" then the MySQL support builtin to your PHP is using an older password scheme than your MySQL database. See http://dev.mysql.com/doc/mysql/en/old-client.html for more information and a workaround to get you up and running without having to recompile or upgrade your PHP.

 
fryfrog

Joined: 2002-10-30
Posts: 3236
Posted: Sat, 2005-02-05 04:01

I guess it has been a while :)

I talked to the author of aphpkb and at first he didn't really seem open to the ideas of some of our modifications. I only assumed he felt this way because he didn't seem to care either way in his emails. About 3 weeks later though, I got a reply that he had actually attempted to make some of the modifications that I had discussed, but could not. I believe that he would be willing to import any changes we make into his project, but we'll probably have to do it mostly by ourselves or at least providing a lot of the help.

Unfortunatly, I am not skilled enough to do this also. Is this something we want to explore? Do we want to replace the current faq system with something like aphpkb? Does anyone want to help me by doing all the hard work? :)

 
bharat
bharat's picture

Joined: 2002-05-21
Posts: 7994
Posted: Wed, 2005-02-09 06:17

Updated the "G2 is slower" FAQ item to add an in-depth discussion of why it's slow and what we're doing about it.

 
mindless
mindless's picture

Joined: 2004-01-04
Posts: 8601
Posted: Thu, 2005-02-24 00:08

added:

Quote:
Q: I get an error about "max key length" installing with MySQL?
A: If you see this error while installing the Core module: Specified key was too long; max key length is 1000 bytes then you need to switch the database character set to something other than utf8. Currently some indexes we use exceed this default MySQL limit if the charset is utf8.

 
valiant

Joined: 2003-01-04
Posts: 32509
Posted: Thu, 2005-02-24 00:38

thumbs up, kudos for taking care of everything :)

 
mindless
mindless's picture

Joined: 2004-01-04
Posts: 8601
Posted: Wed, 2005-03-02 01:52

made some updates to remove alpha references.
removed:

Quote:
Q: I'm unable to install G2 Alpha-4 with Postgres db.. what's wrong?
A: There was a problem in alpha-4 with postgres.. please try a recent nightly snapshot instead (14-Dec for partial fix -- will allow you to install -- 21-Dec for full fix -- will also allow links to work).

Q: I'm trying the User Albums module with G2 Alpha-4 and it does nothing.. what's wrong?
A: There was a bug in alpha-4 with that module.. it does in fact do nothing.. update to a recent snapshot and it will work again.

 
iampedro

Joined: 2003-12-10
Posts: 41
Posted: Tue, 2005-03-15 15:40

Dose it support Access database? FAQ Gallery:c.6FAQ Gallery:b.2

 
valiant

Joined: 2003-01-04
Posts: 32509
Posted: Tue, 2005-03-15 15:58

the only supported data base management systems to date are:
- mysql (tested extensively)
- postgres (tested)
- oracle (too few testers to say something about stability)

 
valiant

Joined: 2003-01-04
Posts: 32509
Posted: Tue, 2005-04-19 14:55

added
Q: How can I move my gallery installation from one server to another?
Q: How can I move my gallery installation from one folder to another?

and added links for the php caches/accelerators to emphasize a little that option.

 
mindless
mindless's picture

Joined: 2004-01-04
Posts: 8601
Posted: Tue, 2005-06-28 17:49

Added:

Quote:
Q: Where I should see dates I see "Wrong charset, cannot convert" or "Illegal character encoding" or "Illegal recode request".. what is wrong?
A: Some operating systems report invalid character sets to PHP leading to errors when trying to convert system-generated content (like day/month names in dates) to UTF-8. Work around this problem by placing the following in config.php:

require_once(dirname(__FILE__) . '/modules/core/classes/GalleryCapabilities.class');
GalleryCapabilities::set('systemCharset', 'ISO-8859-1');

Replace 'ISO-8859-1' with the appropriate character set for your system.

 
mindless
mindless's picture

Joined: 2004-01-04
Posts: 8601
Posted: Fri, 2005-07-01 23:00

Added:

Quote:
Q: Can I rename main.php? Can I install if my server only allows .php4 extension for php files?
A: To use a different main php file after G2 is installed follow these steps:
  1. Copy or symlink main.php to the new filename.
  2. Add a line like this in config.php before the ?> at the end:
    define('GALLERY_MAIN_PHP', 'filename.php');

If your system does not accept ".php" as an extension for PHP files and requires ".php4" then rename install/index.php to install/index.php4 and proceed with the install. After installation follow the steps above to change main.php to main.php4. Note that upgrading is not yet supported with .php4 extension, so post in the forums if you have a setup like this so we get this completed!

[/]

 
cfoutz

Joined: 2005-07-25
Posts: 3
Posted: Mon, 2005-07-25 04:55

I have been looking through FAQs and have yet to find this. I can upload photos. they show up as thumbs, but when I click on one, I get a "Page can not be displayed." ANy ideas why?

Also, I am getting the "Fatal error: Allowed memory size of 8388608 bytes exhausted " when I make a new subfolder (or a page not displayed) and at some other times. i have created the .ht file with the following code that doesn't seem to help...

php_value memory_limit [3200000]

 
valiant

Joined: 2003-01-04
Posts: 32509
Posted: Mon, 2005-07-25 06:27

cfoutz, the second question is answered in the G1 FAQ -> troubleshooting.
php_value memory_limit 24M
is the right syntax for .htaccess and maybe, you are not allowed / you can't change the memory limit with .htaccess.

the former question needs to be addressed in a new topic. please open a new topic and supply more information.
see: http://codex.gallery2.org/index.php/Gallery2:faq#What_information_is_required_when_I_ask_for_help_in_the_forums.3F

 
boss

Joined: 2003-05-28
Posts: 26
Posted: Tue, 2005-07-26 15:46

How about a FAQ regarding the relative merits/disadvantages of the Postgres vs. MySQL choice?

I have looked but not yet found some advice regarding what to choose. I am biased towards postgres, but am wondering if MySQL is faster. (More than 20000 photos, a couple of hundred albums.) I've heard postgres scales better and is more reliable? Don't know if this applies anymore?

 
astav

Joined: 2005-05-16
Posts: 7
Posted: Wed, 2005-08-03 19:07

Where are the thumbnails/resized images stored?

I understand that thumbnails and resizes images are created as they are needed...

Where are they stored?

I use Local Server option to upload most of my pics and use the symlink options too...

Just wondering where they are saved cause i think it is slowing down my gallery a lot!

 
nivekiam
nivekiam's picture

Joined: 2002-12-10
Posts: 16504
Posted: Thu, 2005-08-04 02:20

If you search the forums you'll find that information.

They are stored in your g2data/cache/derivative/ directory in a non-human readable format.

How can the thumbnails be slowing down your gallery install? They are only generated once, either when you upload your image or when you first access that image.

Please start a new topic in the G2 Support forum for support questions. Otherwise your question may become buried and not answered in an off topic subject.

 
eliktronik

Joined: 2005-09-16
Posts: 1
Posted: Fri, 2005-09-16 22:11
fryfrog wrote:

Q: How can I move my gallery installation from one folder to another?
A: Here's a step by step guide:
1. Deactivate and uninstall the url rewrite module if it's activate.
2. Move the gallery folder (rename / move it with an ftp application, a file browser or with a shell).
If you choose to move gallery from a subdirectory to the root of your website, just move all files and directories that are directly in the gallery folder to the web root directory.
3. Edit config.php manually:
- Update the line $gallery->setConfig('data.gallery.base', 'some/path'); if the g2data was within the gallery directory and you moved it.
- Update the line $gallery->setConfig('galleryId', 'domain.com/path'); to match the new path.
- save config.php, you're done.
Contact us in the G2 Development forum if you are having problems or need help.

I tried this and had a bit of trouble. I had to do everything above, but also had to change the value of the mysql entry that contained the path of the installation to reflect the new location (Table g2_PluginParameterMap -> g_parameterName = galleryLocation). Further, I had to go to Site Admin -> System Maintenance -> Delete database cache and clear the cache which contained the old path value.

So either my situation was somehow strange, or maybe we should add this to the FAQ... Can anyone confirm?

 
dialhforme

Joined: 2005-10-06
Posts: 6
Posted: Thu, 2005-10-06 19:53

i have a serius prolben installing g2 in mambo, because it's sendme a error in te moment for saving the config or accesing to others feautres, he errors display
Warning: embed(embed.php): failed to open stream: No such file or directory in /home/floresde/public_html/inventario/components/com_gallery2/classes/core.php on line 127

Fatal error: embed(): Failed opening required 'embed.php' (include_path='.:/usr/lib/php:/usr/local/lib/php') in /home/floresde/public_html/inventario/components/com_gallery2/classes/core.php on line 127
and because i use the modules of mamboforge i had no idea, nd i have no idea of installin your 9mb feature in mambo

 
nivekiam
nivekiam's picture

Joined: 2002-12-10
Posts: 16504
Posted: Fri, 2005-10-07 04:40

And this has to do with the FAQ how? Please post your problem as a new topic.
____________________________________________
Like Gallery? Like the support? Donate now!!! See G2 live here

 
scaturan
scaturan's picture

Joined: 2004-09-12
Posts: 1153
Posted: Thu, 2006-03-16 21:48

move my inquiry to support forum instead. :)

 
fromBelarus

Joined: 2006-08-01
Posts: 2
Posted: Tue, 2006-08-01 19:27

+1 Q: I'm unable to install G2 Alpha-4 with Postgres db.. what's wrong?
A: There was a problem in alpha-4 with postgres.. please try a recent nightly snapshot instead.

google

 
Kingdom_HEarts

Joined: 2006-08-08
Posts: 1
Posted: Tue, 2006-08-08 22:44

Wow thats alot of questions

 
girl3744

Joined: 2006-07-23
Posts: 9
Posted: Mon, 2006-08-21 22:55

I'm having problem with installing gallery2...HELP!!!?

Okay, I've been trying to install my gallery2 and everything went smoothly until Storage setup! It's telling me to create a folder that is not accessible and by doing that, I create a folder and include this code ".htaccess" and others can't access but it's still not letting me through. It kept telling me that the folder doesn't exist but I can see it. Please help me! Here's a picture of where I'm stuck, thanks in advanced!!

http://i113.photobucket.com/albums/n209/image_freak/help.jpg

 
mindless
mindless's picture

Joined: 2004-01-04
Posts: 8601
Posted: Tue, 2006-08-22 05:30

Don't ask for help in this topic.. start a new topic in the support forums.

 
JackRogers

Joined: 2005-10-03
Posts: 3
Posted: Mon, 2007-07-23 16:07

I just migrated a multisite gallery from one machine to another, and found the FAQ only after having problems with the migration. I originally did not uninstall the URL rewrite module before I migrated, so of course this gave me problems. I was also cleaning up some directory structure and moving everything to different locations, as well as converting my data from PostgreSQL to MySQL, so that further complicated the issues.

Anyway, after I managed to disable and uninstall the URL rewrite module on the new server, I tried to reinstall and activate it. Every time I turned it on, it broke everything. I eventually realized that Apache was not obeying the .htaccess directives, and it was easy from there. I had to configure Apache to "AllowOverride" in the gallery directory.

<Directory /full/path/to/gallery2>
    AllowOverride FileInfo Options
</Directory>

This is documented here, but I think it should be placed prominently in the FAQ as well, since that's where it becomes an issue.

Thanks.
Jack

 
TimMakins

Joined: 2007-08-31
Posts: 1
Posted: Sat, 2007-09-01 13:34

Upgrading a G2 that has been installed with the Pre-Installer

If you are reading this before installing Gallery2, my advice would be NOT to use the Preinstaller. Just upload the files using an FTP program, and all will be well. However, my guess is that you are reading this after using the Preinstaller, are staring to panic, and have done a search for Help, just like I did. Here are some tips to help you. The answers ARE on the Gallery2 site, but they are not easy to find.

The Preinstaller is very good, and works very well - there is no question about that. In fact, I would agree with others who have said that it is probably one of the easiest and slickest installers ever. But there's a sting in the tail. The problem comes from the fact that after it has done its job, all the files and folders that it used or installed, including the main Gallery2 folder, are now 'owned' by the System, not by you. This means that after your successful installation, when the Preinstaller recommends that you change the permissions (also called 'CHMOD') of the Gallery2 folder from 777 to 755, and you log in with your favourite FTP program or web interface (Cpanel, Vdeck etc) you will find that you get a message saying "/public_html/gallery2 chmod failed: Operation not permitted". Oh my God - I can't access my own files?! A search of the Gallery 2 documents eventually located a page about the Gallery2:Preinstaller which tells me that I already have a tool on my site to help with this, at http://www.mysite.com/gallery2/lib/support/index.php?chmod But when you access it, you will be asked for your site password, so make sure that you have it handy. This password is not the one that you entered into the '$passPhrase = "";' line of the preinstall.php. It is not the line of text contained in the 'login.txt' file that you had to upload during the installation. If you lose your password, or forget it, or try the wrong one, the CHMOD Tool Page will then tell you 'Failed login attempts: 1 out of a total of 7', and so on, as in your panic, you keep trying to remember what you had originally entered. I have no idea what happens if you get to 7: maybe you will be locked out for good?? Best not to go there! The CHMOD Tool Page trys to be helpful by telling you that your password can be found in your gallery/config.php file like this: $gallery->setConfig('setup.password', 'your password here'); BUT if the system is locked down as mine was, when you point your FTP program there, you will find that its permissions are set to 640, which means you can't view the file. It comes as no surprise to discover that you aren't allowed to change them either! Luckily, there is still one final option open - you must visit this page: Bharat's Cleanup Script. Unzip the file, and upload 'cleanup.php' to the same directory as your gallery2 folder i.e. if your folder is at www.mysite/gallery2 then you should upload the file to www.mysite/cleanup.php Point your browser at that page, and enter the path to your gallery2 folder i.e. /home/~you/public_html/gallery2 Press 'Go' and if you have the path set correctly, all the permissions will be opened up. You can then browse to your config.php file, and find out what your password is. Use that to start the CHMOD Tool Page, and you will then be able to lock your Gallery down again, by making everything read-only.

The Gallery will now work OK, even though you can't access it with an FTP program. Does this matter, I hear you ask? Well, no, I suppose it doesn't really matter. Those of us 'old-timers' from the days of 486's and 10MB hard drives will feel a little nervous that there are files on our servers that we can't access readily, but as long as the Gallery2 program works properly and doesn't introduce any security implications, then heck why not leave it alone?! The [url=http://codex.gallery2.org/Gallery2:Preinstaller"]Gallery2:Preinstaller[/url] page does tell you how to upgrade a Gallery2 installation that has been installed with the Pre-Installer, so I guess its alright.

 
valiant

Joined: 2003-01-04
Posts: 32509
Posted: Sat, 2007-09-01 14:51

@TimMakins:
thanks for your contribution. but this forum topic is obsolete now.
this forum topic has been created before we had a wiki.

please edit the Gallery2:FAQ or the Gallery2:Upgrading page in the wiki.

--------------
Documentation: Support / Troubleshooting | Installation, Upgrade, Configuration and Usage

 
TerryKing
TerryKing's picture

Joined: 2007-01-14
Posts: 22
Posted: Wed, 2008-05-07 02:46

*** OK, Added to the WIKI ****

PROBLEM: A Gallery2 installation WORKS when the url without "www" is used, but FAILS (All broken images) when the URL starting with "www" is used.
SOLUTION: Both Deactivate AND UNINSTALL "Url rewrite".

I chased this all over, thru the FAQ's and Troubleshooting, without finding the answer. Please add this to the FAQ.

Regards, Terry King ...On South China Sea in Shekou