User guide
Troubleshooting Zenpage March 02nd, 2009
- If I change the language in Zenphoto’s options Zenpage’s admin pages are still in english.
- The zenpage theme is in english even if I change the language in Zenphoto’s options.
- TinyMCE and/or the file manager are not translated.
- Is it possible to configure TinyMCE differently?
- Can I use another WSIWYG editor than TinyMCE?
- Where does the file manger store uploaded files?
- Is it possible to rename the “uploaded” folder and put it somewhere else?
- On my pages/articles list on the admin some pages/articles are greyed out and I can’t edit them.
- What is a permaTitleLink?
- Why is there a check box for editing the Title Link? It seems editable even though the box is not checked.
- Is it possible to extend Zenpage myself?
- Can I change the names of the theme files pages.php and news.php?
- The search does not work for articles and pages!
- Can I use tags from Zenphoto on my news articles?
- Where do I report bugs I find in Zenpage?
- How to assign a user to a page or article?
- How do I get images into my pages or news articles?
- How to change the upload file size limit for the File Manager?
- What is the CombiNews mode?
- I have added pages and articles but I don’t see them on my site!
If I change the language in Zenphoto’s options Zenpage’s admin pages are still in english.
Zenpage’s is now an included fully official plugin and it’s translation is now included within the main Zenphoto translation file. However, the join is quite new so not all languages might have been updated to incude the Zenpage translation.
Of course you are welcome to provide a translation. Please read http://www.zenphoto.org/2008/05/translating-tutorial
The zenpage theme is in english even if I change the language in Zenphoto’s options.
Zenpage’s is now an included fully official plugin and it’s translation is now included within the main Zenphoto translation file. However, the join is quite new so not all languages might have been updated to incude the Zenpage translation.
Of course you are welcome to provide a translation. Please read http://www.zenphoto.org/2008/05/translating-tutorial
TinyMCE and/or the file manager are not translated.
TinyMCE and Ajax File Manager are third party solutions that use their own translation files and technique. There are already some languages preinstalled. These are bascially those that are currently completed or partly available for Zenphoto itself and listed here: http://www.zenphoto.org/trac/report/9 But you might want to check their own project sites for more or also updated translations:
- Ajax File Manger language packs: http://www.phpletter.com/Language-Packs-Download-Center/
- TinyMCE language packs: http://services.moxiecode.com/i18n/
Is it possible to configure TinyMCE differently?
Yes, of course. The file editor_config.js.php within the zenpage plugin folder contains the configuration code for TinyMCE. You will find all info about configuration options on the TinyMCE wiki: http://wiki.moxiecode.com/index.php/TinyMCE:Index
Can I use another WSIWYG editor than TinyMCE?
Generally yes. The file editor_config.js.php within the zenpage plugin folder contains the configuration code for TinyMCE. This could possibly be replaced with configuration code for another editor but it has not been tried and is not supported. Also the Ajax File Manager Zenpage uses may not work as a plugin with another editor. According to Ajax File Manger’s creator phpletter it is compatible with FCKeditor though.
Where does the file manger store uploaded files?
The files are stored within the folder uploaded that is located in the root folder of your Zenphoto installation and that is created while running Zenpage setup automatically.
Is it possible to rename the “uploaded” folder and put it somewhere else?
Yes, open plugins/tiny_mce/plugins/ajaxfilemanger/inc/config.base.php and in the lines 51 and 52 you find these lines:
define('CONFIG_SYS_DEFAULT_PATH', '../../../../../uploaded/'); //accept relative path only
define('CONFIG_SYS_ROOT_PATH', '../../../../../uploaded/'); //accept relative path only
Change the name and the path (must be relative paths!) as you like but remember this will be overwritten with every update. It will not be made an option because the file manager is a third party product that gets updated itself so the modification of it is kept to a minimun to make updates easier.
On my pages/articles list on the admin some pages/articles are greyed out and I can’t edit them.
These pages/articles are locked by the original author or last author who edited them. Only that author’s user will be able to edit or unlock them or any user with full admin rights.
What is a permaTitleLink?
The titlelink is the URL name of a page/article/category that is automatically generated seo friendly when adding a page. This is basically the equivalent to Zenphoto’s album name and image file name and unique to that page/article/category even if using Zenphoto’s multilingual mode.
If you don’t check the permaTitlelink option the titlelink will be newly generated everytime you change the title of a page/article/category. This can lead to broken links if someone or a search engine links to you. This concept is taken from Wordpress where it is called permalink (or slug). It is referred to that as titlelink in all functions so it is called that that here, too.
Why is there a check box for editing the Titlelink? It seems editable even though the box is not checked.
In case you are not satisfied with the automatic generation of the titlelink you can edit it. For example if you have a long title you might want to have a shorter url name or maybe the seo friendly generation cleared out something you want to be there, then you can edit it.
Changes are only saved if you check the checkbox. If you checked the permaTitlelink option, checking the “edit titlelink” checkbox will override the permaTitlelink option.
Is it possible to extend Zenpage myself?
Zenpage is just a little more complex Zenphoto plugin, but just a plugin. This means you can write just another Zenphoto plugin or a theme custom function that uses Zenpage functions to provide custom functionality. You only can extend the theme relevant part of Zenpage that way unless you want to hack the plugin itself. That of course is not recommended because of possible problems with further updates. If you have a suggestion please use the Zenphoto forums.
Can I change the names of the theme files pages.php and news.php?
Yes. First rename the files to what you like (don’t use special characters to be on the secure side), then enter these names including the .php suffixes on Zenpage’s plugin option for it. If you use mod_rewrite you have to adjust the rewrite rules to match the new names, too.
The search does not work for articles and pages!
Zenphoto’s search engine also includes articles and pages. If it does not work and you are using none of the standard themes it might not be implemented in your theme. See the theming tutorial how to implement this.
Can I use tags from Zenphoto on my news articles?
Yes, Zenpage supports tags for news articles as well as pages.
Where do I report bugs I find in Zenpage?
Please use the Zenphoto bugtracker for that. Open a ticket and select the component Zenpage and report your problem.
How to assign a user to a specific page or article?
This is the way if you are the master admin and want to set up something for users with lower rights:
- Create a user with rights for one album and Zenpage rights.
- Create a new page/article as master admin for that user.
- Now select the user the page/article should belong to from the author dropdown.
- Now set the page/article to locked for changes and save it. Then only admins with full admin rights or that user will be able to edit or delete that page. For all others the link and the icon buttons should be grayed out.
Note that every user with Zenpage rights can set every page or article locked for changes himself that is not already locked for changes. It does not matter if he is the original author or not.
How do I get images into my pages or news articles?
There are now two ways:
- You can use Phpletter’s Ajax File Manager that is included as a TinyMCE plugin. That file manager is either accessible via the “Manage files” button on the main pages or main articles page or via the image button onTinyMCE tool bar. You can view some screenshots on how to use it here: How to use the file manager
You can use this file manager to upload and manage many formats that Zenphoto itself does not support. Note that files you upload with this are placed within the uploaded folder and are independend from the normal albums. Visit also the site of the creators of this file manager: www.phpletter.com. - Also you can use tinyZenpage, a default plugin to the by default enabled text editor TinyMCE, to access images, albums as well as pages, articles or news cateogries for including. Here are some tinyZenpage screenshots about it and there is also some general info on the Zenpage plugin page.
How to change the upload file size limit for the file manager?
There is no option but you can change it directly in the file
zp-core/plugins/tiny_mce/plugins/ajaxfilemanger/inc/config.base.php in line 70.
What is the CombiNews mode?
This mode shows the lastest gallery items like images incl. videos and audio or albums mixed within the news section as if they were news articles. The image/album title is shown as the title and the image/album description as the article content. There is of course also a RSS mode available for CombiNews (see the documentation).
Note since news articles are only sorted by date the CombiNews might lead to unexpected results if you set the image sortorder to “id”. Try using “date” or “mtime”.
Image and albums and articles are still independend and nothing is changed on your site, except the display. You can use this to easily setup a photoblog or audio/podcast blog for example.
View a live demo here
I have added pages and articles but I don’t see them on my site!
A theme with Zenpage support is required to see them. Themes with Zenpage support are currently:
- Zenpage-default (official and included)
- effervescence+ (official and included)
- zpfocus (third party)
- zpGalleriffic (third party)
- zinenaboxpacity (third party)
Of course you can setup any theme with Zenpage support yourself. Read on the theming tutorial how to do it.