Last modified by Vincent Massol on 2017/09/05

<
From version < 21.1 >
edited by Ramona Conoro
on 2015/05/22
To version < 23.1 >
edited by Vincent Massol
on 2017/09/01
>
Change comment: Copied from platform:DevGuide.FAQTutorial.FAQTutorialAWM

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.RamonaConoro
1 +XWiki.VincentMassol
Content
... ... @@ -4,48 +4,54 @@
4 4  
5 5  This tutorial will show you how to build a Frequently Asked Questions (FAQ) Application much like the one you can find on the [[FAQ page>>xwiki:FAQ.WebHome]]. This is a very simple application that is made using App Within Minutes Application. You may frequently use this technique as the basis for several different kinds of applications.
6 6  
7 -= Application Overview=
7 +{{warning}}
8 +If you've already followed the [[Manual FAQ Tutorial>>DevGuide.FAQTutorial.FAQTutorialManual]] or installed the [[FAQ Application>>extensions:Extension.FAQ Application]] you'll need to do one of 2 things before you can take this tutorial:
9 +* Delete the ##FAQ## space (if you've followed the Manual FAQ Tutorial) or uninstall the FAQ Application (if you've installed the FAQ Application)
10 +* or simply follow the tutorial below but instead of using ##FAQ## as the application name, use another name such as ##MyFAQ##.
11 +{{/warning}}
8 8  
13 += Application Overview =
14 +
9 9  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.
10 10  
11 -= Creating the FAQ Application=
17 += Creating the FAQ Application =
12 12  
13 13  Start creating your FAQ Application by going to the App Within Minutes home page. Since XWiki Enterprise 4.2 it's available from the "Applications" panel.
14 14  
15 -{{image reference='FAQ-Go1.png'/}}
21 +{{image reference="FAQ-Go1.png"/}}
16 16  
17 -{{image reference='FAQ-Go2.png'/}}
23 +{{image reference="FAQ-Go2.png"/}}
18 18  
19 19  There you can see listed the existing applications. Click on the "Create Application" button to start the wizard.
20 20  
21 -{{image reference='FAQ-Go3.png'/}}
27 +{{image reference="FAQ-Go3.png"/}}
22 22  
23 23  In the first step you have to provide the application name, which will determine the application home page URL and the application space. Each application is mapped to an XWiki space.
24 24  
25 -{{image reference='FAQ-Go4.png'/}}
31 +{{image reference="FAQ-Go4.png"/}}
26 26  
27 27  In the second step you define the application structure. Drag and drop a "Long Text" field from the Field Palette. Then change the name from "Long Text" to "Answer". This will be the "Answer" field.
28 28  
29 -{{image reference='FAQ-NEW1.png'/}}
35 +{{image reference="FAQ-NEW1.png"/}}
30 30  
31 31  In the last step you customize the way the home page of your application will look like. Click on the drop-down menu and select the "Creation date" item then click on the "add" button. This will add a "Creation date" column in your application live table.
32 32  
33 -{{image reference='FAQ-NEW2.png'/}}
39 +{{image reference="FAQ-NEW2.png"/}}
34 34  
35 -= Creating new FAQ entries=
41 += Creating new FAQ entries =
36 36  
37 37  To create a new FAQ entry click on the "ADD NEW ENTRY" button from the "Actions" panel.
38 38  
39 -{{image reference='FAQ-NEW3.png'/}}
45 +{{image reference="FAQ-NEW3.png"/}}
40 40  
41 41  Write your question and click on the "add" button.
42 42  
43 -{{image reference='FAQ-NEW4.png'/}}
49 +{{image reference="FAQ-NEW4.png"/}}
44 44  
45 45  Click on the "Save & View" button. Go back to the "FAQ.WebHome" page to see the list of existing questions.
46 46  
47 -= Answering to FAQ questions=
53 += Answering to FAQ questions =
48 48  
49 49  To answer to a question click on the "edit" button in the "Action" column from the live table, enter your answer in the "Answer" field and press the "Save & View" button.
50 50  
51 -{{image reference='FAQ-NEW5.png'/}}
57 +{{image reference="FAQ-NEW5.png"/}}

Get Connected