Hide last authors
Sorin Burjan 1.1 1 {{box cssClass="floatinginfobox" title="**Contents**"}}
2 {{toc/}}
3 {{/box}}
4
Manuel Smeria 10.2 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.
Sorin Burjan 1.1 6
Vincent Massol 22.1 7 {{warning}}
Ecaterina Moraru (Valica) 23.4 8 If you've already followed the [[Manual FAQ Tutorial>>xwiki:Documentation.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:
Vincent Massol 22.1 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}}
12
Vincent Massol 23.1 13 = Application Overview =
Sorin Burjan 1.1 14
15 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.
16
Vincent Massol 23.1 17 = Creating the FAQ Application =
Sorin Burjan 1.1 18
Ecaterina Moraru (Valica) 24.1 19 Start creating your FAQ Application by going to the App Within Minutes home page. Since XWiki 4.2 it's available from the "Applications" panel.
Manuel Smeria 10.2 20
Vincent Massol 23.1 21 {{image reference="FAQ-Go1.png"/}}
Manuel Smeria 10.2 22
Vincent Massol 23.1 23 {{image reference="FAQ-Go2.png"/}}
Sorin Burjan 1.1 24
25 There you can see listed the existing applications. Click on the "Create Application" button to start the wizard.
26
Vincent Massol 23.1 27 {{image reference="FAQ-Go3.png"/}}
Benoit RICHARD 12.1 28
Sorin Burjan 1.1 29 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.
30
Vincent Massol 23.1 31 {{image reference="FAQ-Go4.png"/}}
Sorin Burjan 1.1 32
Manuel Smeria 10.2 33 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.
Sorin Burjan 1.1 34
Vincent Massol 23.1 35 {{image reference="FAQ-NEW1.png"/}}
Sorin Burjan 1.1 36
Manuel Smeria 10.2 37 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.
Sorin Burjan 1.1 38
Vincent Massol 23.1 39 {{image reference="FAQ-NEW2.png"/}}
Sorin Burjan 1.1 40
Vincent Massol 23.1 41 = Creating new FAQ entries =
Sorin Burjan 1.1 42
43 To create a new FAQ entry click on the "ADD NEW ENTRY" button from the "Actions" panel.
44
Vincent Massol 23.1 45 {{image reference="FAQ-NEW3.png"/}}
Sorin Burjan 1.1 46
Manuel Smeria 10.2 47 Write your question and click on the "add" button.
Sorin Burjan 1.1 48
Vincent Massol 23.1 49 {{image reference="FAQ-NEW4.png"/}}
Sorin Burjan 1.1 50
Manuel Smeria 10.2 51 Click on the "Save & View" button. Go back to the "FAQ.WebHome" page to see the list of existing questions.
Sorin Burjan 1.1 52
Vincent Massol 23.1 53 = Answering to FAQ questions =
Sorin Burjan 1.1 54
Manuel Smeria 10.2 55 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.
Sorin Burjan 1.1 56
Vincent Massol 23.1 57 {{image reference="FAQ-NEW5.png"/}}

Get Connected