Changes for page Resources

Last modified by Agnease on 2026/05/28 08:53

From version 1.4
edited by Agnease
on 2026/05/19 03:37
Change comment: There is no comment for this version
To version 10.8
edited by Agnease
on 2026/05/26 08:54
Change comment: There is no comment for this version

Summary

Details

Page properties
Title
... ... @@ -1,1 +1,1 @@
1 -resources
1 +Resources
Content
... ... @@ -1,103 +1,112 @@
1 1  {{velocity}}
2 2  #set ($discard = $xwiki.ssx.use('PublicWebSite.WebHome'))
3 3  {{html clean="false"}}
4 -
5 - <section class="resource-header" aria-labelledby="hero-title">
6 - <div class="container">
7 - <div class="text-center">
8 - <div class="hero-kicker">
9 - <i class="fa fa-book" aria-hidden="true"></i>
10 - XWiki resources
11 - </div>
4 + ## PAGE HEADER
5 + <section class="hero hero-centered" aria-labelledby="hero-title">
6 + <div class="container hero-inner">
7 + <div class="hero-kicker">
8 + <i class="fa fa-book" aria-hidden="true"></i>
9 + XWiki resources
12 12   </div>
13 -
14 - <h1 id="hero-title">Practical XWiki guidance for better long-term maintenance</h1>
15 -
16 - <p class="resource-summary">
17 - Articles and practical notes about XWiki upgrades, custom development, governance, security,
18 - integrations and maintainable knowledge platforms.
11 + <h1 id="hero-title">XWiki resources for upgrades, security and maintainability</h1>
12 + <p class="lead">
13 + Practical articles for teams that want to keep XWiki secure, upgradeable and easier to maintain over time.
19 19   </p>
20 20   </div>
21 21   </section>
22 -
23 - <section class="resources-index-page">
17 + ## RESOURCE CARDS
18 + #set ($resourceItems = [{
19 + 'title': 'What should an XWiki security review include',
20 + 'icon': 'shield',
21 + 'url': 'resources.xwiki-security-review',
22 + 'content': 'A practical overview of what to review in an XWiki instance: version status, access rights, authentication, extensions, custom code, infrastructure, backups and operations.',
23 + 'linkLabel': 'Read article'
24 + },{
25 + 'title': 'Why upgrade your XWiki instance',
26 + 'icon': 'refresh',
27 + 'url': 'resources.why-upgrade-xwiki',
28 + 'content': 'A practical explanation of why regular XWiki upgrades matter for security, stability, extension compatibility and long-term maintenance.',
29 + 'linkLabel': 'Read article'
30 + },{
31 + 'title': 'How to customize XWiki safely',
32 + 'icon': 'code',
33 + 'url': 'resources.xwiki-custom-development',
34 + 'content': 'Guidance for organizing XWiki custom code, scripts, templates and extensions so they remain easier to maintain across upgrades.',
35 + 'linkLabel': 'Read article'
36 + }])
37 + <section id="resources-list" class="services resources-index-page" aria-labelledby="resources-title">
24 24   <div class="container">
25 -
26 - <div class="resources-intro">
27 - <p>
28 - XWiki is a flexible platform, but the long-term quality of an instance depends on how it is configured,
29 - customized, upgraded and maintained. These resources are written for teams that want to keep their
30 - XWiki platform stable, useful and easier to evolve over time.
31 - </p>
39 + <h2 id="resources-title">Useful XWiki resources</h2>
40 + <p class="section-intro">
41 + Focused guidance for production XWiki platforms, covering upgrade planning, custom development,
42 + maintainability and safer long-term evolution.
43 + </p>
44 + <div class="services-grid resources-grid">
45 + #foreach ($entry in $resourceItems)
46 + <article class="service resource-card">
47 + <div class="service-icon" aria-hidden="true">
48 + <i class="fa fa-$entry.icon"></i>
49 + </div>
50 + <div class="service-body">
51 + <h4>$entry.title</h4>
52 + <p>$entry.content</p>
53 + <p class="card-link">
54 + <a href="$xwiki.getURL($entry.url)">$entry.linkLabel</a>
55 + </p>
56 + </div>
57 + </article>
58 + #end
32 32   </div>
33 -
34 - <div class="resources-grid">
35 -
36 - <article class="resource-card">
37 - <div class="resource-card-icon">
38 - <i class="fa fa-refresh" aria-hidden="true"></i>
39 - </div>
40 - <div class="resource-card-body">
41 - <div class="resource-card-label">Upgrade guidance</div>
42 - <h2>
43 - <a href="$xwiki.getURL('resources.why-upgrade-xwiki')">
44 - Why upgrading your XWiki instance should be a regular priority
45 - </a>
46 - </h2>
47 - <p>
48 - Understand why postponed upgrades can increase security exposure, compatibility risk and
49 - long-term maintenance cost.
50 - </p>
51 - <a class="resource-card-link" href="$xwiki.getURL('resources.why-upgrade-xwiki')">
52 - Read the article
53 - <i class="fa fa-angle-right" aria-hidden="true"></i>
54 - </a>
55 - </div>
56 - </article>
57 -
58 - <article class="resource-card">
59 - <div class="resource-card-icon">
60 - <i class="fa fa-code" aria-hidden="true"></i>
61 - </div>
62 - <div class="resource-card-body">
63 - <div class="resource-card-label">Custom development</div>
64 - <h2>
65 - <a href="$xwiki.getURL('resources.xwiki-custom-development')">
66 - How to customize XWiki safely without creating upgrade problems
67 - </a>
68 - </h2>
69 - <p>
70 - Learn how to organize custom XWiki code, scripts, templates and extensions so they remain
71 - maintainable across upgrades.
72 - </p>
73 - <a class="resource-card-link" href="$xwiki.getURL('resources.xwiki-custom-development')">
74 - Read the article
75 - <i class="fa fa-angle-right" aria-hidden="true"></i>
76 - </a>
77 - </div>
78 - </article>
79 -
60 + </div>
61 + </section>
62 + ## UPCOMING TOPICS
63 + #set ($upcomingTopicItems = [{
64 + 'title': 'Upgrade planning',
65 + 'content': 'How to prepare XWiki upgrades when custom code, extensions, authentication and workflows are involved.'
66 + },{
67 + 'title': 'Access and security',
68 + 'content': 'Practical notes on permissions, authentication options, MFA, SSO and security-aware administration.'
69 + },{
70 + 'title': 'Maintainable customization',
71 + 'content': 'How to extend XWiki without creating unnecessary upgrade and maintenance problems.'
72 + }])
73 + <section class="split-section" aria-labelledby="upcoming-title">
74 + <div class="container">
75 + <div class="split-grid">
76 + <div class="split-copy">
77 + <h2 id="upcoming-title">More practical XWiki topics coming soon</h2>
78 + <p>
79 + Future resources will cover XWiki access rights, authentication, migrations, security reviews,
80 + structured applications, workflows and practical administration patterns.
81 + </p>
82 + <p>
83 + The goal is to publish useful guidance that helps teams make better decisions before an upgrade,
84 + customization, migration or long-term maintenance engagement.
85 + </p>
86 + </div>
87 + <ol class="process-list">
88 + #foreach ($entry in $upcomingTopicItems)
89 + <li>
90 + <strong>$entry.title</strong>
91 + $entry.content
92 + </li>
93 + #end
94 + </ol>
80 80   </div>
81 -
82 - <div class="resources-next">
83 - <h2>More topics coming soon</h2>
96 + </div>
97 + </section>
98 + ## CTA
99 + <section class="cta-section" aria-labelledby="resource-cta-title">
100 + <div class="container">
101 + <div class="cta-panel">
102 + <h2 id="resource-cta-title">Need help with an XWiki project?</h2>
84 84   <p>
85 - Future resources will cover XWiki access rights, authentication, migrations, security reviews,
86 - structured applications, workflows and practical administration patterns.
87 - </p>
88 - </div>
89 -
90 - <div class="resource-cta">
91 - <h3>Need help with an XWiki project?</h3>
92 - <p>
93 93   If your XWiki instance needs an upgrade, custom development, integration work or a technical review,
94 - we can help you evaluate the current state and define the safest next steps.
105 + Agnease can help evaluate the current state and define practical next steps.
95 95   </p>
96 96   <a class="btn btn-primary" href="$xwiki.getURL('contact.WebHome')">Contact Agnease</a>
97 97   </div>
98 -
99 99   </div>
100 100   </section>
101 -
102 102  {{/html}}
103 103  {{/velocity}}
Agnease.Code.SEODetailsClass[0]
metaDescription
... ... @@ -1,0 +1,1 @@
1 +Practical XWiki resources from Agnease covering upgrades, security, custom development, maintainability, workflows and long-term platform care.
metaTitle
... ... @@ -1,0 +1,1 @@
1 +XWiki Resources and Guides for Upgrades, Security and Development | Agnease