<
From version < 100.1 >
edited by Ogis Tarkan
on 2017/05/12
To version < 100.2 >
edited by Vincent Massol
on 2017/05/12
>
Change comment: Move the need to be an Advanced user to the prerequisites section at the top

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.OgisTarkan
1 +XWiki.VincentMassol
Content
... ... @@ -16,6 +16,10 @@
16 16  
17 17  All through this tutorial you should refer to the [[XWiki Data Model>>DevGuide.DataModel]] for information on XWiki's data model. You might also use the [[XWiki Scripting Guide>>DevGuide.Scripting]] to get you started with scripting in XWiki and manipulating XWiki objects. In addition, this tutorial will introduce the concepts of Authoring Templates and Page Design Sheets, patterns that you will find particularly useful in creating XWiki applications. Completing this tutorial is a recommended prerequisite for anyone who wants to build custom applications on the XWiki engine.
18 18  
19 +{warning}}
20 +Make sure that your user is an [[Advanced user>>Features.PageEditing||anchor="HAdvancedMode"]] before following this tutorial since you'll need for example to use the wiki editor (##Wiki > Edit## menu).
21 +{{/warning}}
22 +
19 19  = Application Overview =
20 20  
21 21  The FAQ application allows users to post a question by entering the question into a simple form field and then submitting the form. The question then appears in a list along with all other questions that have been previously posted. Users can click on the questions to view both the question and answer in a consistently styled view. If the question has not yet been answered, any user can post an answer to the question by editing the page. In edit mode, the page will display a web form that is the same for every FAQ page.
... ... @@ -49,8 +49,7 @@
49 49  {{image reference="CreateANewClass1.png"/}}
50 50  )))
51 51  * As you can see in the Breadcrumb below the new page will be created at location ##XWiki > FAQ##. In practice the Class Wizard will automatically prefix the page name with ##Class## (you could also enter ##FAQClass## as the page name directly).
52 -* Now it would be nice to have it created in a new location such as ##FAQ > FAQ Class##. Since the ##FAQ## parent doesn't exist we cannot use the Tree picker button. Thus click the Pencil button as shown in the following image and replace ##XWiki## by ##FAQ##.
53 -{{info}}If you don't see pencil, try to change user type to ##Advanced## in ##User profile > Preferences > User type## and reload page.{{/info}}(((
56 +* Now it would be nice to have it created in a new location such as ##FAQ > FAQ Class##. Since the ##FAQ## parent doesn't exist we cannot use the Tree picker button. Thus click the Pencil button as shown in the following image and replace ##XWiki## by ##FAQ##.(((
54 54  {{image reference="CreateANewClass2.png"/}}
55 55  )))
56 56  * In technical terms you're creating a page named ##FAQClass## (with a title of "FAQ Class") located in a space also called ##FAQ## and thus the technical reference is ##FAQ.FAQClass##.
... ... @@ -114,8 +114,7 @@
114 114  * You should see a warning message with the text "The sheet is not bound to the class so it won't be applied automatically when a page that has an object of this class is displayed". Click the "Bind the sheet to the class" link that appears after the text. **What this does is important**:
115 115  ** It adds an object of type ##XWiki.ClassSheetBinding## to the ##FAQ.FAQClass" document. Basically it ties the FAQ Class to the Sheet.##
116 116  ** **It's because of this object that users will be sent to form edition mode when editing FAQ entries**
117 -* Now click on "View the sheet document". This takes you to the ##FAQ.FAQSheet## page which you can edit in wiki mode and see its default content:
118 -{{info}}If you don't see ##Wiki## in edit menu, try to change user type to ##Advanced## in ##User profile > Preferences > User type## and reload page.{{/info}}(((
120 +* Now click on "View the sheet document". This takes you to the ##FAQ.FAQSheet## page which you can edit in wiki mode and see its default content:(((
119 119  {{code language="none"}}
120 120  {{velocity}}
121 121  ## You can modify this page to customize the presentation of your object.

Get Connected