<
From version < 39.1 >
edited by Ecaterina Moraru (Valica)
on 2017/08/21
To version < 39.2 >
edited by Ecaterina Moraru (Valica)
on 2017/08/21
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -1,39 +1,101 @@
1 -{{box cssClass="floatinginfobox"}}
2 -(% style="width: 250px" %)
3 -If you are interested in participating to the XWiki project development itself or in building it from sources, you should refer to the [[Community wiki>>dev:Main.WebHome]].
4 -You still have a question?
5 -[[Subscribe to the mailing lists!>>dev:Community.MailingLists]]
6 -{{/box}}
1 +{{velocity output="false"}}
2 +$xwiki.ssx.use('xwiki:Main.Documentation')
3 +{{/velocity}}
7 7  
8 -XWiki is a [[second generation wiki>>platform:Main.SecondGenerationWiki]] that provides all the basic content management and administration features of common wikis, but with much more. XWiki takes the wiki approach to a whole new level by providing enhanced features and capabilities. With XWiki, you can build simple applications, extend the platform with custom plugins, or even build complex Web applications.
5 +(% class="row cards" %)
6 +(((
7 +(% class="col-xs-12 col-sm-6 col-md-4 cards-container" %)
8 +(((
9 +{{html wiki="true" clean="false"}}
10 +<div class="card card1">
11 + <div class="card-body">
12 + <h4 class="card-title">[[XWiki API Guide>>platform:DevGuide.APIGuide]]</h4>
13 + <p class="card-text">Guide that explains the main XWiki APIs.</p>
14 + </div>
15 +</div>
16 +{{/html}}
17 +)))
9 9  
10 -= Quick Start =
19 +(% class="col-xs-12 col-sm-6 col-md-4 cards-container" %)
20 +(((
21 +{{html wiki="true" clean="false"}}
22 +<div class="card card1">
23 + <div class="card-body">
24 + <h4 class="card-title">[[XWiki API Reference>>platform:DevGuide.API]]</h4>
25 + <p class="card-text">The API is available as a JavaDoc. It presents the objects and properties that you can access with scripting.</p>
26 + </div>
27 +</div>
28 +{{/html}}
29 +)))
11 11  
12 -; **[[App Within Minutes>>extensions:Extension.App Within Minutes Application]]**
13 -: Tool to build Applications without any technical knowledge
31 +(% class="col-xs-12 col-sm-6 col-md-4 cards-container" %)
32 +(((
33 +{{html wiki="true" clean="false"}}
34 +<div class="card card1">
35 + <div class="card-body">
36 + <h4 class="card-title">[[XWiki Scripting>>platform:DevGuide.Scripting]]</h4>
37 + <p class="card-text">Classes and Scripting will allow you to create basic to complex web applications at the XWiki document layer without the need for compiling code or deploying software components.</p>
38 + </div>
39 +</div>
40 +{{/html}}
41 +)))
42 +)))
14 14  
15 -= Reference documentation =
44 +== Reference ==
16 16  
17 -; **[[XWiki Architecture>>platform:DevGuide.Architecture]]**
18 -: Understanding how XWiki is architected and how to extend it.
19 19  
20 -; **[[XWiki Data Model>>platform:DevGuide.DataModel]]**
21 -: You should start by understanding XWiki's data model of Classes, Properties, and Objects. They'll be needed to build applications at the presentation (document) level.
47 +(% class="row cards" %)
48 +(((
49 +(% class="col-xs-12 col-sm-6 col-md-4 cards-container" %)
50 +(((
51 +{{html wiki="true" clean="false"}}
52 +<div class="card card2">
53 + <div class="card-body">
54 + <h5 class="card-title">[[XWiki Architecture>>platform:DevGuide.Architecture]]</h5>
55 + <h6 class="card-subtitle mb-2">Understanding how XWiki is architected and how to extend it.</h6>
56 + </div>
57 +</div>
58 +{{/html}}
59 +)))
22 22  
23 -; **[[XWiki Scripting>>platform:DevGuide.Scripting]]**
24 -: Once you understand XWiki's Data Model you'll be able to program directly in the documents you edit. XWiki integrates both Velocity and Groovy scripting. Together, Classes and Scripting will allow you to create basic to complex web applications at the XWiki document layer without the need for compiling code or deploying software components.
61 +(% class="col-xs-12 col-sm-6 col-md-4 cards-container" %)
62 +(((
63 +{{html wiki="true" clean="false"}}
64 +<div class="card card2">
65 + <div class="card-body">
66 + <h5 class="card-title">[[XWiki Data Model>>platform:DevGuide.DataModel]]</h5>
67 + <h6 class="card-subtitle mb-2">Describes XWiki's data model of Classes, Properties, and Objects. They'll be needed to build applications at the presentation (document) level.</h6>
68 + </div>
69 +</div>
70 +{{/html}}
71 +)))
25 25  
26 -; **[[XWiki API Guide>>platform:DevGuide.APIGuide]]**
27 -: Guide that explains the main XWiki APIs. Quick access to the [[XWiki API Reference>>DevGuide.API]].
73 +(% class="col-xs-12 col-sm-6 col-md-4 cards-container" %)
74 +(((
75 +{{html wiki="true" clean="false"}}
76 +<div class="card card2">
77 + <div class="card-body">
78 + <h5 class="card-title">[[Database Schema>>platform:DevGuide.DatabaseSchema]]</h5>
79 + <h6 class="card-subtitle mb-2">For advanced users who like to know everything, check out the database tables created by XWiki.</h6>
80 + </div>
81 +</div>
82 +{{/html}}
83 +)))
84 +)))
28 28  
29 -; **[[Extension Points List>>platform:ExtensionPoint.WebHome]]**
30 -: List all available Extension Points.
86 +----
31 31  
88 +{{box cssClass="floatinginfobox col-xs-4"}}
89 +If you are interested in participating to the XWiki project development itself or in building it from sources, you should refer to the [[Community wiki>>dev:Main.WebHome]].
90 +You still have a question?
91 +[[Subscribe to the mailing lists!>>dev:Community.MailingLists]]
92 +{{/box}}
93 +
32 32  ; **[[Front-end Resources>>platform:DevGuide.FrontendResources]]**
33 33  : A description of the tools and frameworks used in XWiki. You'll find information about how you can use external libraries such as YUI and SmartClient and internal XWiki libraries for your the development of your in-wiki applications or for the development of XWiki products themselves. You'll also find the documentation of StyleSheet resources created specifically for the XWiki project.
34 34  
35 -; **[[XWiki Module Reference>>extensions:Main.WebHome]]**
36 -: Reference documentation for the various Modules of XWiki.
97 +; **[[Extension Points List>>platform:ExtensionPoint.WebHome]]**
98 +: List all available Extension Points.
37 37  
38 38  ; **[[Saving Data>>platform:DevGuide.SavingData]]**
39 39  : Description of all the possibilities you have to save Data from within the XWiki Platform
... ... @@ -41,36 +41,100 @@
41 41  ; **[[URL Architecture>>URL Architecture]]**
42 42  : Explains how XWiki URLs work, the format of the [[Standard URL Scheme>>Standard URL Format]] and how to configure them.
43 43  
44 -= Tutorials and Guides =
106 +; **[[XWiki Module Reference>>extensions:Main.WebHome]]**
107 +: Reference documentation for the various Modules of XWiki.
45 45  
46 -; **[[Creating an Extension>>DevGuide.CreatingExtensions.WebHome]]**
47 -: Explains how to create an XWiki Extension
109 +(% class="row cards" %)
110 +(((
48 48  
49 -; **[[How to use Velocity in XWiki pages>>XWikiVelocityTraining]]**
50 -: A presentation that explains how to write applications in XWiki (using Velocity, the XWiki Class system, and the API...).
112 +)))
51 51  
52 -; **[[Creating a FAQ application>>FAQTutorial]]**
53 -: Demonstrates how to create a FAQ application much like the one you can find on this Wiki [[FAQ page>>xwiki:FAQ.WebHome]], either using **Classes/Objects/Sheets/Templates** and Scripting or using the **[[App Within Minutes extension>>extensions:Extension.App Within Minutes Application]]** to produce a FAQ application. Completing this tutorial is a recommended prerequisite for anyone who wants to build custom applications on the XWiki engine at the document or presentation layer.
114 +== Tutorials ==
54 54  
55 -; **[[Creating a Groovy Class>>platform:DevGuide.GroovyClassHelloWorldTutorial]]**
56 -: Demonstrates how to put Groovy code in one page and then reuse it by importing it from another page.
57 57  
58 -; **[[Writing an Event Listener>>platform:DevGuide.WritingEventListenerTutorial]]**
59 -: Explains how to write an [[Event Listener>>extensions:Extension.Observation Module]] in order to perform some action when an event happens in the wiki. Examples of events are Document changed, Object modified, and more.
117 +(% class="row cards" %)
118 +(((
119 +(% class="col-xs-12 col-sm-6 col-md-4 cards-container" %)
120 +(((
121 +{{html wiki="true" clean="false"}}
122 +<div class="card card2">
123 + <div class="card-body">
124 + <h5 class="card-title">[[Creating a FAQ application>>FAQTutorial]]</h5>
125 + <h6 class="card-subtitle mb-2">Demonstrates how to create a FAQ application, either using Classes/Objects/Sheets/Templates and Scripting or using the App Within Minutes. Completing this tutorial is a recommended prerequisite for anyone who wants to build custom applications on the XWiki engine at the document or presentation layer.</h6>
126 + </div>
127 +</div>
128 +{{/html}}
129 +)))
60 60  
61 -; **[[Creating a TODO application in XWiki>>http://www.theserverside.com/tt/articles/article.tss?l=XWiki]]**
62 -: Another helpful tutorial to using XWiki's classes, velocity scripts, hibernate queries for a dashboard.
63 - Shows well the power of XWiki.
131 +(% class="col-xs-12 col-sm-6 col-md-4 cards-container" %)
132 +(((
133 +{{html wiki="true" clean="false"}}
134 +<div class="card card2">
135 + <div class="card-body">
136 + <h5 class="card-title">[[Creating a TODO application in XWiki>>http://www.theserverside.com/tt/articles/article.tss?l=XWiki]]</h5>
137 + <h6 class="card-subtitle mb-2">Another helpful tutorial to using XWiki's classes, velocity scripts, hibernate queries for a dashboard.</h6>
138 + </div>
139 +</div>
140 +{{/html}}
141 +)))
64 64  
143 +(% class="col-xs-12 col-sm-6 col-md-4 cards-container" %)
144 +(((
145 +{{html wiki="true" clean="false"}}
146 +<div class="card card2">
147 + <div class="card-body">
148 + <h5 class="card-title">[[Creating an Extension>>DevGuide.CreatingExtensions.WebHome]]</h5>
149 + <h6 class="card-subtitle mb-2">Explains how to create an XWiki Extension</h6>
150 + </div>
151 +</div>
152 +{{/html}}
153 +)))
154 +)))
155 +
156 +----
157 +
158 +; **[[Creating an XWiki Rendering Macros>>platform:DevGuide.WritingMacros]]**
159 +: How to develop XWiki Rendering macros (available in XWiki Syntax 2.0 only)
160 +
161 +; **[[Creating New XClass Property Types>>platform:DevGuide.CreatingNewXClassPropertyTypes]]**
162 +: See how you can easily extend the [[class editor>>platform:Features.PageEditing#HClasseseditingmode]] with new custom property types.
163 +
65 65  ; **[[Creating a form with validation and tooltips>>platform:DevGuide.Creating a form with validation and tooltips]]**
66 66  : Quick and efficient tutorial to set-up validation using regular expression and groovy scripts, as well as tooltips
67 67  
68 -; **[[Writing XWiki Rendering Macros>>platform:DevGuide.WritingMacros]]**
69 -: How to develop XWiki Rendering macros (available in XWiki Syntax 2.0 only)
167 +; **[[Creating a Tree View>>CreatingATreeView]]**
168 +: A tutorial on how to create a tree view for any tree structure you may have in XWiki, using the [[Tree Macro>>extensions:Extension.Tree Macro]].
70 70  
71 -; **[[Writing an XWiki Component>>platform:DevGuide.WritingComponents]]**
170 +; **[[Creating a custom SOLR search for an AppWithinMinutes application>>WritingCustomSolrSearchForAWM]]**
171 +: Tutorial to show how to write a customized SOLR search screen in XWiki for an [[AWM application>>extensions:Extension.App Within Minutes Application]]. For this example we have used the [["Expense Report" application>>extensions:Extension.Expense Report Application]].
172 +
173 +; **[[Creating a Master-Detail view>>platform:DevGuide.MasterDetailTutorial]]**
174 +: Shows how to implement a Master-Details view
175 +
176 +; **[[Creating an Event Listener>>platform:DevGuide.WritingEventListenerTutorial]]**
177 +: Explains how to write an [[Event Listener>>extensions:Extension.Observation Module]] in order to perform some action when an event happens in the wiki. Examples of events are Document changed, Object modified, and more.
178 +
179 +; **[[Creating a Groovy Class>>platform:DevGuide.GroovyClassHelloWorldTutorial]]**
180 +: Demonstrates how to put Groovy code in one page and then reuse it by importing it from another page.
181 +
182 +; **[[Creating an XWiki Component>>platform:DevGuide.WritingComponents]]**
72 72  : Getting started with the new XWiki components architecture: introduction to this new design, a step-by-step guide to writing an XWiki component (the recommended way of creating XWiki plugins) and some guidelines and development good practices in this area.
73 73  
185 +; **[[Creating a Plugin>>platform:DevGuide.CreatingPlugins]]**
186 +: After you've learnt how to write applications at the document level you may want to go further and program plugins in Java to extend XWiki's view engine, as well as add hooks into different parts of the core engine.
187 +
188 +
189 +(% class="row cards" %)
190 +(((
191 +
192 +)))
193 +
194 +== Guides ==
195 +
196 +
197 +; **[[How to use Velocity in XWiki pages>>XWikiVelocityTraining]]**
198 +: A presentation that explains how to write applications in XWiki (using Velocity, the XWiki Class system, and the API...).
199 +
74 74  ; **[[Skin eXtensions>>platform:DevGuide.SkinExtensionsTutorial]]**
75 75  : Illustrate XWiki's [[Skin eXtensions>>platform:Features.Skins#HSkinseXtensions]] mechanism that allows developers to pull extra Javascript and stylesheet files on demand or for all wiki pages without modifying the wiki templates and skin. The tutorial guides through the creation of minimal stylesheet and Javascript extensions, and continues with a complete exemple of a real-world extension to demonstrate the power of XWiki's skin eXtensions!
76 76  
... ... @@ -77,18 +77,9 @@
77 77  ; **[[Internationalizing Applications>>platform:DevGuide.InternationalizingApplications]]**
78 78  : Learn how to write internationalized applications.
79 79  
80 -; **[[Creating New XClass Property Types>>platform:DevGuide.CreatingNewXClassPropertyTypes]]**
81 -: See how you can easily extend the [[class editor>>platform:Features.PageEditing#HClasseseditingmode]] with new custom property types.
82 -
83 83  ; **[[Custom Mapping>>platform:DevGuide.CustomMapping]]**
84 84  : Learn how to use Custom Mapping when you need to map XWiki Classes to your own database tables or when you need extra performance for complex data.
85 85  
86 -; **[[Creating Plugins>>platform:DevGuide.CreatingPlugins]]**
87 -: After you've learnt how to write applications at the document level you may want to go further and program plugins in Java to extend XWiki's view engine, as well as add hooks into different parts of the core engine.
88 -
89 -; **[[Writing a custom SOLR search for an AppWithinMinutes application>>WritingCustomSolrSearchForAWM]]**
90 -: Tutorial to show how to write a customized SOLR search screen in XWiki for an [[AWM application>>extensions:Extension.App Within Minutes Application]]. For this example we have used the [["Expense Report" application>>extensions:Extension.Expense Report Application]].
91 -
92 92  ; **[[Integrating JavaScript Libraries>>IntegratingJavaScriptLibraries]]**
93 93  : A tutorial on how we can use [[WebJars>>extensions:Extension.WebJars Integration]] and [[RequireJS>>http://requirejs.org/]] to integrate JavaScript libraries in XWiki. Moreover, you'll see how you can package your own JavaScript code as a WebJar in order to benefit from various code quality tools (static code analysis with [[jshint>>http://jshint.com/]], integration testing with [[Jasmine>>http://jasmine.github.io/]]).
94 94  
... ... @@ -95,26 +95,18 @@
95 95  ; **[[Performing Asynchronous Tasks>>PerformingAsynchronousTasks]]**
96 96  : A tutorial on how to perform long-running and expensive operations in XWiki from a background thread using the [[Job Module>>extensions:Extension.Job Module]].
97 97  
98 -; **[[Creating a Tree View>>CreatingATreeView]]**
99 -: A tutorial on how to create a tree view for any tree structure you may have in XWiki, using the [[Tree Macro>>extensions:Extension.Tree Macro]].
215 +; **[[AJAX and JSON calls>>snippets:Extension.AJAX example]]**
216 +: How to perform AJAX calls, retrieve JSON results from a Velocity page and to update your application's UI.
100 100  
101 -; **[[Master-Detail Tutorial>>platform:DevGuide.MasterDetailTutorial]]**
102 -: Shows how to implement a Master-Details view
103 -
104 -; **[[AJAX and JSON Tutorial>>snippets:Extension.AJAX example]]**
105 -: A tutorial on how to perform AJAX calls, retrieve JSON results from a Velocity page and to update your application's UI.
106 -
107 107  ; **[[Best Practices>>platform:DevGuide.BestPractices]]**
108 108  : A set of best practices for developing applications with XWiki.
109 109  
110 -= Further reading =
221 +(% class="row cards" %)
222 +(((
111 111  
112 -; **[[XWiki API Reference>>platform:DevGuide.API]]**
113 -: The API is available as a JavaDoc. It presents the objects and properties that you can access with scripting.
224 +)))
114 114  
115 -; **[[Database Schema>>platform:DevGuide.DatabaseSchema]]**
116 -: For advanced users who like to know everything, check out the database tables created by XWiki.
226 +== Drafts ==
117 117  
118 -= Draft documentation =
119 119  
120 -See the [[Draft space of the Development Wiki>>dev:Drafts.WebHome]].
229 +See the [[Drafts>>dev:Drafts.WebHome]] for other topics that are still under review.

Get Connected