FAQ
(→General questions) |
(→Can I contribute to this wiki?: Removed spam link.) |
||
| (63 intermediate revisions by 24 users not shown) | |||
| Line 1: | Line 1: | ||
| − | === General questions === | + | == Wiki related questions == |
| + | === Can I contribute to this wiki? === | ||
| + | '''Yes you can!''' Contribution is welcome. Feel free to edit every page :). Just register with username and password and start editing, have fun! | ||
| + | |||
| + | === I want to edit a page, but how does the formatting work? === | ||
| + | There is a page with editing help: [[Help:Editing]], take a look at it it is quite easy. | ||
| + | misto | ||
| + | |||
| + | === It is possible to enable code highlighting? === | ||
| + | Sure, a module for mediawiki which does this for you is installed. Just add <tt><nowiki><source lang="java"></nowiki></tt> in your article and the code will be highlighted. | ||
| + | |||
| + | === Searching through this wiki === | ||
| + | You can use the search function shipped with mediawiki or you can use google by entering: "'''site:opencms-wiki.org your search term'''". | ||
| + | |||
| + | == General questions == | ||
| + | === What is OpenCms? === | ||
| + | OpenCms is a professional level open source content management written in Java with Servlets and JSP. It is platform independent and could be run on every operating system where Java is supported. Currently it is developed by [http://alkacon.com Alkacon] with support from the OpenCms community. To get more information about OpenCms take a look at the [http://www.opencms.org/ homepage]. | ||
| + | |||
| + | === What hardware do I need to get OpenCms running? === | ||
| + | Take a look at the [[Hardware_requirements|Hardware requirements page]]. | ||
| + | === What software do I need to get OpenCms running? === | ||
| + | Take a look at the [[Finding_and_installing_the_prerequisites|Software requirements page]]. | ||
| + | |||
| + | === Is there such a thing as a step-by-step tutorial to create a website from scratch? === | ||
| + | Not at the moment, but there is a discussion going on on the mailing list as of today about the possibility of writing it collaboratively. | ||
| + | |||
| + | == Technical questions == | ||
| + | === Why does the default OpenCms url contain /opencms/opencms/? === | ||
| + | The first /opencms/ is the folder of your OpenCms installation in the webapps folder of your servlet container (tomcat,jboss,etc.). The second is a servlet mapping to the main OpenCms servlet which handles the requests. You can install OpenCms as root-application of you servlet container to get rid of the first /opencms/. During the installation process you can rename the servlet mapping (for example to cms) to shorten the second /opencms/.Alternatively there is a guide how to get rid of /opencms/opencms/ shipped with the alcacon documentation. See also [[Removing /opencms/opencms from site url]] | ||
| + | === My OpenCms upgrade fails, what are common pitfalls? === | ||
| + | A common pitfall is that your Servlet container(Tomcat,JBoss,etc.) has no write access to the OpenCms installation, check the permission and give the servlet-container write access. | ||
| + | |||
| + | Another pitfall is that the upgrade wizard is not able to open a display, which can be fixed by starting the servlet container with the following java arguments: | ||
| + | -Djava.awt.headless=true | ||
| + | ===How can I create a custom 404 and 500 Error Page?=== | ||
| + | Your custom error pages have to be called handle404.html, handle500.html etc and must be placed inside the /system/handler/ directory. | ||
| + | |||
| + | ==== However... ==== | ||
| + | You can style the existing one by setting the <tt>template</tt> property of the folder <tt>/system/handler</tt>. Change this from the default (which is <tt>/system/handler/template/handlertemplate</tt>) to your own template jsp. The only requirement to the template jsp is that it must contain a <tt>cms:template element=""</tt> for head and foot, like this: | ||
| + | <cms:template element="head"> | ||
| + | <html>... | ||
| + | <nowiki><!-- The error page content will be inserted after this --></nowiki> | ||
| + | </cms:template> | ||
| + | <cms:template element="foot"> | ||
| + | <nowiki><!-- End your html markup here --></nowiki> | ||
| + | </html> | ||
| + | </cms:template> | ||
| + | |||
| + | Take a look at the default template for further assistance. | ||
| + | |||
| + | === Changing error page content === | ||
| + | |||
| + | If you want to provide own content for the error page, you do not have to replace the /system/handler/handleNNN.html file, but according to | ||
| + | javadoc of [http://www.opencms.org/javadoc/core/org/opencms/jsp/util/CmsJspStatusBean.html#getPageContent%28java.lang.String%29 CmsJspStatusBean.getPageContent(String)] you can set the ''template-elements'' property of /system/handler/handleNNN.html to any file, or edit the content of the default /system/handler/contents/contentNNN.html content file. | ||
| + | |||
| + | == User Management == | ||
| + | === What is the difference between webusers and normal users? === | ||
| + | The webusers are not allowed to login into the OpenCms workplace. You can use them to create a restricted area on your homepage. There is a howto how to create a restricted area on your homepage: [[How to create a restricted area on your homepage]]. Note: Webusers have been removed from OpenCMS 7.0. | ||
| + | |||
| + | === I lost the password of the user "Admin", what can I do? === | ||
| + | If you have database access you can reset it with the following SQL query: | ||
| + | UPDATE CMS_USERS SET USER_PASSWORD='ISMvKXpXpadDiUoOSoAfww==' WHERE USER_NAME='Admin'; | ||
| + | This sets the "Admin" password to 'admin'. '''NOTE: Use this at your own risk!''' | ||
| + | |||
| + | === I want to deny the "Users" group access to a certain folder, how? === | ||
| + | When you try to change the permission of certain folder to deny the "Users" access to a certain folder you see that this this group is not editable. The trick is to '''add the "Users" group again''' to get the possibility to change the groups permission. | ||
| + | |||
| + | == Extending the System == | ||
| + | === How can I create my own login page? === | ||
| + | See: [[Custom Login Page]]. | ||
Latest revision as of 16:20, 26 July 2012
Contents |
Can I contribute to this wiki?
Yes you can! Contribution is welcome. Feel free to edit every page :). Just register with username and password and start editing, have fun!
I want to edit a page, but how does the formatting work?
There is a page with editing help: Help:Editing, take a look at it it is quite easy. misto
It is possible to enable code highlighting?
Sure, a module for mediawiki which does this for you is installed. Just add <source lang="java"> in your article and the code will be highlighted.
Searching through this wiki
You can use the search function shipped with mediawiki or you can use google by entering: "site:opencms-wiki.org your search term".
General questions
What is OpenCms?
OpenCms is a professional level open source content management written in Java with Servlets and JSP. It is platform independent and could be run on every operating system where Java is supported. Currently it is developed by Alkacon with support from the OpenCms community. To get more information about OpenCms take a look at the homepage.
What hardware do I need to get OpenCms running?
Take a look at the Hardware requirements page.
What software do I need to get OpenCms running?
Take a look at the Software requirements page.
Is there such a thing as a step-by-step tutorial to create a website from scratch?
Not at the moment, but there is a discussion going on on the mailing list as of today about the possibility of writing it collaboratively.
Technical questions
Why does the default OpenCms url contain /opencms/opencms/?
The first /opencms/ is the folder of your OpenCms installation in the webapps folder of your servlet container (tomcat,jboss,etc.). The second is a servlet mapping to the main OpenCms servlet which handles the requests. You can install OpenCms as root-application of you servlet container to get rid of the first /opencms/. During the installation process you can rename the servlet mapping (for example to cms) to shorten the second /opencms/.Alternatively there is a guide how to get rid of /opencms/opencms/ shipped with the alcacon documentation. See also Removing /opencms/opencms from site url
My OpenCms upgrade fails, what are common pitfalls?
A common pitfall is that your Servlet container(Tomcat,JBoss,etc.) has no write access to the OpenCms installation, check the permission and give the servlet-container write access.
Another pitfall is that the upgrade wizard is not able to open a display, which can be fixed by starting the servlet container with the following java arguments:
-Djava.awt.headless=true
How can I create a custom 404 and 500 Error Page?
Your custom error pages have to be called handle404.html, handle500.html etc and must be placed inside the /system/handler/ directory.
However...
You can style the existing one by setting the template property of the folder /system/handler. Change this from the default (which is /system/handler/template/handlertemplate) to your own template jsp. The only requirement to the template jsp is that it must contain a cms:template element="" for head and foot, like this:
<cms:template element="head"> <html>... <!-- The error page content will be inserted after this --> </cms:template> <cms:template element="foot"> <!-- End your html markup here --> </html> </cms:template>
Take a look at the default template for further assistance.
Changing error page content
If you want to provide own content for the error page, you do not have to replace the /system/handler/handleNNN.html file, but according to javadoc of CmsJspStatusBean.getPageContent(String) you can set the template-elements property of /system/handler/handleNNN.html to any file, or edit the content of the default /system/handler/contents/contentNNN.html content file.
User Management
What is the difference between webusers and normal users?
The webusers are not allowed to login into the OpenCms workplace. You can use them to create a restricted area on your homepage. There is a howto how to create a restricted area on your homepage: How to create a restricted area on your homepage. Note: Webusers have been removed from OpenCMS 7.0.
I lost the password of the user "Admin", what can I do?
If you have database access you can reset it with the following SQL query:
UPDATE CMS_USERS SET USER_PASSWORD='ISMvKXpXpadDiUoOSoAfww==' WHERE USER_NAME='Admin';
This sets the "Admin" password to 'admin'. NOTE: Use this at your own risk!
I want to deny the "Users" group access to a certain folder, how?
When you try to change the permission of certain folder to deny the "Users" access to a certain folder you see that this this group is not editable. The trick is to add the "Users" group again to get the possibility to change the groups permission.
Extending the System
How can I create my own login page?
See: Custom Login Page.
