Skip to Content
Last modified by Alex Cotiuga on 2026/07/27 06:09
From version 16.25
edited by Alex Cotiuga
on 2026/06/16 16:35
Change comment: There is no comment for this version
To version 18.16
edited by Alex Cotiuga
on 2026/07/09 20:28
Change comment: There is no comment for this version

Summary

Details

Page properties
Default language
... ... @@ -1,1 +1,0 @@
1 -en
Hidden
... ... @@ -1,1 +1,1 @@
1 -false
1 +true
Content
... ... @@ -3,33 +3,115 @@
3 3   #set ($statusCode = 400)
4 4   #set ($message = 'The request could not be sent. Please try again or contact Agnease by email at alex@agnease.com.')
5 5  
6 + #set ($className = 'Agnease.Code.ContactRequest.ContactRequestClass')
7 + #set ($allowedProperties = [
8 + 'scope',
9 + 'alreadyUseXWiki',
10 + 'name',
11 + 'email',
12 + 'hosting',
13 + 'customDevelopment',
14 + 'timeline',
15 + 'users',
16 + 'sourcePage'
17 + ])
18 +
6 6   #set ($name = '')
7 7   #set ($email = '')
8 - #set ($contactWebSite = '')
21 + #set ($scope = '')
22 + #set ($contactWebsite = '')
23 + #set ($startedAtRaw = '')
24 + #set ($sourcePage = '')
9 9  
26 + ## Extract only the values we need for validation.
10 10   #foreach ($parameterName in $request.parameterNames)
11 - #set ($propertyName = $parameterName.split('_0_')[1])
12 - #if ($propertyName == 'name')
13 - #set ($name = $stringtool.trim($request.get($parameterName)))
14 - #elseif ($propertyName == 'email')
15 - #set ($email = $stringtool.trim($request.get($parameterName)))
16 - #elseif ($propertyName == 'contactWebsite')
17 - #set ($contactWebSite = $stringtool.trim($request.get($parameterName)))
28 + #set ($propertyParts = $parameterName.split('_0_'))
29 + #if ($propertyParts.size() > 1)
30 + #set ($propertyName = $propertyParts[1])
31 + #set ($propertyValue = $stringtool.trim($request.get($parameterName)))
32 +
33 + #if ($propertyName == 'name')
34 + #set ($name = $propertyValue)
35 + #elseif ($propertyName == 'email')
36 + #set ($email = $propertyValue)
37 + #elseif ($propertyName == 'scope')
38 + #set ($scope = $propertyValue)
39 + #elseif ($propertyName == 'contactWebsite')
40 + #set ($contactWebsite = $propertyValue)
41 + #elseif ($propertyName == 'contactStartedAt')
42 + #set ($startedAtRaw = $propertyValue)
43 + #end
18 18   #end
19 19   #end
20 20  
21 - #if ("$!contactWebSite.trim()" != '')
22 - #set ($statusCode = 400)
23 - #set ($message = 'The request could not be sent. Please try again or contact Agnease by email.')
24 - #elseif ("$!name" == '' && "$!email" == '')
25 - #set ($statusCode = 400)
47 + #set ($spamScore = 0)
48 +
49 + ## Honeypot: real users should never fill this field.
50 + #if ("$!contactWebsite" != '')
51 + #set ($spamScore = $spamScore + 5)
52 + #end
53 +
54 + ## Submission timing check.
55 + #if ("$!startedAtRaw" == '')
56 + ## The field is expected from the real form, so missing it is suspicious.
57 + #set ($spamScore = $spamScore + 2)
58 + #else
59 + #set ($startedAt = $numbertool.toNumber($startedAtRaw))
60 + #if ("$!startedAt" == '')
61 + #set ($spamScore = $spamScore + 2)
62 + #else
63 + #set ($now = $datetool.systemDate.time)
64 + #set ($elapsed = $now - $startedAt)
65 +
66 + ## Reject very fast submissions.
67 + #if ($elapsed > 0 && $elapsed < 10000)
68 + #set ($spamScore = $spamScore + 3)
69 + #end
70 + #end
71 + #end
72 +
73 + ## Random-looking name: long single token.
74 + #if ($name.length() >= 16 && !$name.contains(' '))
75 + #set ($spamScore = $spamScore + 2)
76 + #end
77 +
78 + ## Random-looking project description: long single token.
79 + #if ($scope.length() >= 12 && !$scope.contains(' '))
80 + #set ($spamScore = $spamScore + 2)
81 + #end
82 +
83 + ## Suspicious email local part with many dots and tiny fragments.
84 + #set ($emailParts = $email.split('@'))
85 + #if ($emailParts.size() == 2)
86 + #set ($localPart = $emailParts[0])
87 + #set ($localFragments = $localPart.split('\.'))
88 + #set ($dotCount = $localFragments.size() - 1)
89 + #set ($oneCharFragments = 0)
90 +
91 + #foreach ($fragment in $localFragments)
92 + #if ($fragment.length() == 1)
93 + #set ($oneCharFragments = $oneCharFragments + 1)
94 + #end
95 + #end
96 +
97 + #if ($dotCount >= 4 && $oneCharFragments >= 3)
98 + #set ($spamScore = $spamScore + 2)
99 + #end
100 + #else
101 + #set ($spamScore = $spamScore + 2)
102 + #end
103 +
104 + ## Human-facing validation.
105 + #if ("$!name" == '' && "$!email" == '')
26 26   #set ($message = 'Please enter your name and email.')
27 27   #elseif ("$!name" == '')
28 - #set ($statusCode = 400)
29 29   #set ($message = 'Please enter your name.')
30 30   #elseif ("$!email" == '')
31 - #set ($statusCode = 400)
32 32   #set ($message = 'Please enter your email address.')
111 + #elseif ("$!scope" == '' || $scope.length() < 30)
112 + #set ($message = 'Please add a short description of your XWiki project, question or issue.')
113 + #elseif ($spamScore >= 3)
114 + #set ($message = 'The request could not be sent. Please add a clearer description of your XWiki request or contact Agnease by email.')
33 33   #else
34 34   #try('contactException')
35 35   #set ($now = $datetool.get('yyyyMMddHHmm'))
... ... @@ -36,11 +36,22 @@
36 36   #set ($random = $mathtool.random(100000, 999999))
37 37   #set ($uniqueName = "ContactRequest-${now}-${random}")
38 38   #set ($contactRequestDoc = $xwiki.getDocumentAsAuthor('ContactRequests.' + $uniqueName))
39 - #set ($contactRequestObj = $contactRequestDoc.getObject('Agnease.Code.ContactRequest.ContactRequestClass', true))
121 + #set ($contactRequestObj = $contactRequestDoc.getObject($className, true))
40 40  
123 + ## Save only known ContactRequest fields.
41 41   #foreach ($parameterName in $request.parameterNames)
42 - #set ($propertyName = $parameterName.split('_0_')[1])
43 - #set ($discard = $contactRequestObj.set($propertyName, $request.get($parameterName)))
125 + #if ($parameterName == 'sourcePage')
126 + #set ($sourcePage = $stringtool.trim($request.get($parameterName)))
127 + #set ($discard = $contactRequestObj.set('Agnease.Code.ContactRequest.ContactRequestClass_0_sourcePage', $stringtool.trim($request.get($parameterName))))
128 + #end
129 + #set ($propertyParts = $parameterName.split('_0_'))
130 + #if ($propertyParts.size() > 1)
131 + #set ($propertyName = $propertyParts[1])
132 +
133 + #if ($allowedProperties.contains($propertyName))
134 + #set ($discard = $contactRequestObj.set($propertyName, $stringtool.trim($request.get($parameterName))))
135 + #end
136 + #end
44 44   #end
45 45  
46 46   #set ($discard = $contactRequestDoc.saveAsAuthor())
... ... @@ -75,15 +75,20 @@
75 75   ## As a measure to avoid high load on website.
76 76   Tell us more about your project at <a href="mailto:alex@agnease.com">alex@agnease.com</a>
77 77   #else
171 + #set ($hiddenProperties = ['sourcePage'])
78 78   <form id="contactForm">
79 79   <dl>
80 80   #foreach ($property in $xclass.properties)
175 + #set ($hiddenPropertiesCSS = '')
176 + #if ($hiddenProperties.contains($property.name))
177 + #set ($hiddenPropertiesCSS = 'class="hidden"')
178 + #end
81 81   #if ($property.name == 'hosting')
82 82   <hr>
83 83   <h3>Optional project details</h3>
84 84   <p>These details help us understand the scope and suggest practical next steps.</p>
85 85   #end
86 - <dt #if (!$editing && $hasEdit)
184 + <dt $hiddenPropertiesCSS #if (!$editing && $hasEdit)
87 87   class="editableProperty"
88 88   #set ($xobjectPropertyReference = $xobject.getPropertyReference($property.name))
89 89   data-property="$escapetool.xml($services.model.serialize($xobjectPropertyReference))"
... ... @@ -96,7 +96,7 @@
96 96   ## Support for specifying a translation key as hint in the property definition.
97 97   <span class="xHint">$!escapetool.xml($services.localization.render($property.hint))</span>
98 98   </dt>
99 - <dd>$doc.display($property.name, 'edit').replace('{{html clean="false" wiki="false"}}', '').replace("{{/html}}", '')</dd>
197 + <dd $hiddenPropertiesCSS>$doc.display($property.name, 'edit').replace('{{html clean="false" wiki="false"}}', '').replace("{{/html}}", '')</dd>
100 100   #end
101 101   #if (!$xclass.properties || $xclass.properties.size() == 0)
102 102   ## Keep the empty definition term in order to have valid HTML.
... ... @@ -107,15 +107,17 @@
107 107   <p class="xHint">* Your information will only be used to respond to this request.</p>
108 108   ## Hidden fields to catch requests filled by bots.
109 109   <div class="contact-hp-wrapper" aria-hidden="true">
110 - <label for="contactWebsite">Website</label>
208 + <label for="Agnease.Code.ContactRequest.ContactRequestClass_0_contactWebsite">Website</label>
111 111   <input
112 - id="contactWebsite"
210 + id="Agnease.Code.ContactRequest.ContactRequestClass_0_contactWebsite"
113 113   type="text"
114 - name="contactWebsite"
212 + name="Agnease.Code.ContactRequest.ContactRequestClass_0_contactWebsite"
115 115   autocomplete="off"
116 116   tabindex="-1"
117 117   />
118 118   </div>
217 + <input type="hidden" name="Agnease.Code.ContactRequest.ContactRequestClass_0_contactStartedAt" value="$datetool.systemDate.time" />
218 + <input type="hidden" name="sourcePage" value="$!{request.sourcePage}" />
119 119   <input id="contactSubmit" type="submit" class="btn btn-primary" value="Send my request">
120 120   </form>
121 121   #end
... ... @@ -136,9 +136,13 @@
136 136   {{/html}}
137 137   {{html clean="false"}}
138 138   </div>
139 - <div class="col-md-5">
140 - <div class="widget">
141 - <h4>$services.icon.renderHTML('check') How Agnease can help</h4>
239 + <div class="col-md-5 contact-side-panel">
240 + <div class="split-copy contact-help-panel">
241 + <h2>
242 + <i class="fa fa-check-circle" aria-hidden="true"></i>
243 + How Agnease can help
244 + </h2>
245 +
142 142   <ul>
143 143   <li>XWiki upgrades and long-term maintenance</li>
144 144   <li>Knowledge bases, intranets, SOP and documentation workflows</li>
... ... @@ -148,14 +148,21 @@
148 148   <li>Security-aware reviews and platform stabilization</li>
149 149   </ul>
150 150   </div>
151 - <div class="widget">
152 - <h4>$services.icon.renderHTML('right') What happens next?</h4>
153 - <ol>
154 - <li>Your request is reviewed.</li>
155 - <li>You receive a reply with clarifying questions or suggested next steps.</li>
156 - <li>If useful, we schedule a short call to discuss scope, timeline, and estimated effort.</li>
157 - </ol>
158 - </div>
255 +
256 + <ol class="process-list contact-process-list">
257 + <li>
258 + <strong>Your request is reviewed</strong>
259 + The project description is checked to understand the context and initial scope.
260 + </li>
261 + <li>
262 + <strong>You receive a reply</strong>
263 + Agnease replies with clarifying questions or suggested next steps.
264 + </li>
265 + <li>
266 + <strong>A short call can be scheduled</strong>
267 + If useful, we discuss scope, timeline and estimated effort together.
268 + </li>
269 + </ol>
159 159   </div>
160 160   </div>
161 161  {{/html}}
XWiki.JavaScriptExtension[0]
code
... ... @@ -21,10 +21,12 @@
21 21   url: serviceURL,
22 22   data: $.param(form.serializeArray())
23 23   }).done(function (data) {
24 + console.log(data)
24 24   successBox.find('.box div p').text(data.message);
25 25   successBox.removeClass('hidden');
26 26   form[0].reset();
27 27   }).fail(function (xhr) {
29 + console.log('fail' + xhr)
28 28   var message = xhr.responseJSON && xhr.responseJSON.message ? xhr.responseJSON.message
29 29   : 'The request could not be sent. Please try again or contact Agnease by email at alex@agnease.com';
30 30   errorBox.find('.box div p').text(message);
XWiki.StyleSheetExtension[0]
code
... ... @@ -1,73 +1,19 @@
1 -@brand: #00937D;
2 -@brand-strong: #007B6A;
3 -@text: #2D3A34;
4 -@muted: #5B6B64;
5 -@line: #E4ECE9;
6 -@radius: 16px;
7 -@shadow-sm: 0 6px 20px rgba(0,0,0,.06);
8 -@shadow: 0 12px 36px rgba(0,0,0,.08);
9 -@maxw: 1140px;
1 +/* ===== Contact page side panel ===== */
10 10  
11 -/* ===== Contact page widgets ===== */
12 -#mainContentArea {
13 - padding: 0;
3 +.contact-side-panel {
4 + padding-top: 10px;
14 14  }
15 15  
16 -.col-xs-5 {
17 - padding-top: 45px;
7 +.contact-help-panel {
8 + margin-bottom: 18px;
18 18  }
19 19  
20 -.col-xs-5 .widget {
21 - margin-bottom: 16px;
22 - padding: 16px;
11 +.contact-process-list li {
12 + min-height: auto;
23 23  }
24 24  
25 -.col-xs-5 .widget h4 {
26 - display: flex;
27 - align-items: center;
28 - gap: 8px;
29 - margin: 0 0 10px;
30 - padding-bottom: 8px;
31 - border-bottom: 1px solid fade(@line, 60%);
32 - color: @text;
33 - font-size: 18px;
34 - line-height: 1.25;
35 -}
36 -
37 -.col-xs-5 .widget h4 .fa,
38 -.col-xs-5 .widget h4 .glyphicon {
39 - color: @brand;
40 - font-size: 15px;
41 -}
42 -
43 -.col-xs-5 .widget ul,
44 -.col-xs-5 .widget ol {
45 - margin: 0;
46 - padding-left: 1.2rem;
47 - color: @muted;
48 -}
49 -
50 -.col-xs-5 .widget li {
51 - margin: 5px 0;
52 - line-height: 1.4;
53 -}
54 -
55 -.col-xs-5 .widget p {
56 - margin: 0 0 8px;
57 - color: @muted;
58 - line-height: 1.45;
59 -}
60 -
61 -.col-xs-5 .widget p:last-child {
62 - margin-bottom: 0;
63 -}
64 -
65 -.col-xs-5 .widget a {
66 - color: @brand;
67 - font-weight: 700;
68 -}
69 69  /* CSS for hidden field to identify requests filled by bots. */
70 -.contact-hp-wrapperss {
16 +.contact-hp-wrapper {
71 71   position: absolute;
72 72   left: -9999px;
73 73   width: 1px;
... ... @@ -74,3 +74,9 @@
74 74   height: 1px;
75 75   overflow: hidden;
76 76  }
23 +
24 +@media (max-width: 991px) {
25 + .contact-side-panel {
26 + padding-top: 24px;
27 + }
28 +}
XWiki.JavaScriptExtension[1]
cache
... ... @@ -1,0 +1,1 @@
1 +long
code
... ... @@ -1,0 +1,31 @@
1 +require(['jquery'], function ($) {
2 + $(function () {
3 + var sourcePageField = $('input[name="sourcePage"]');
4 +
5 + if (!sourcePageField.length || sourcePageField.val()) {
6 + return;
7 + }
8 +
9 + if (!document.referrer) {
10 + return;
11 + }
12 +
13 + try {
14 + var referrerUrl = new URL(document.referrer);
15 +
16 + if (referrerUrl.origin !== window.location.origin) {
17 + return;
18 + }
19 +
20 + var sourcePage = referrerUrl.pathname
21 + .replace(/^\/bin\//, '')
22 + .replace(/\/$/, '');
23 +
24 + if (sourcePage) {
25 + sourcePageField.val(sourcePage);
26 + }
27 + } catch (e) {
28 + // Ignore invalid referrer values.
29 + }
30 + });
31 +});
name
... ... @@ -1,0 +1,1 @@
1 +document referrer catcher
use
... ... @@ -1,0 +1,1 @@
1 +currentPage