Skip to Content
Last modified by Alex Cotiuga on 2026/07/27 06:09
From version 16.39
edited by Alex Cotiuga
on 2026/06/16 16:48
Change comment: There is no comment for this version
To version 18.29
edited by Alex Cotiuga
on 2026/07/09 21:06
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,36 +3,114 @@
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 = '')
21 + #set ($scope = '')
8 8   #set ($contactWebsite = '')
23 + #set ($startedAtRaw = '')
9 9  
25 + ## Extract only the values we need for validation.
10 10   #foreach ($parameterName in $request.parameterNames)
11 11   #set ($propertyParts = $parameterName.split('_0_'))
12 12   #if ($propertyParts.size() > 1)
13 - #set ($propertyName = $parameterName.split('_0_')[1])
29 + #set ($propertyName = $propertyParts[1])
30 + #set ($propertyValue = $stringtool.trim($request.get($parameterName)))
31 +
14 14   #if ($propertyName == 'name')
15 - #set ($name = $stringtool.trim($request.get($parameterName)))
33 + #set ($name = $propertyValue)
16 16   #elseif ($propertyName == 'email')
17 - #set ($email = $stringtool.trim($request.get($parameterName)))
35 + #set ($email = $propertyValue)
36 + #elseif ($propertyName == 'scope')
37 + #set ($scope = $propertyValue)
18 18   #elseif ($propertyName == 'contactWebsite')
19 - #set ($contactWebsite = $stringtool.trim($request.get($parameterName)))
39 + #set ($contactWebsite = $propertyValue)
40 + #elseif ($propertyName == 'contactStartedAt')
41 + #set ($startedAtRaw = $propertyValue)
20 20   #end
21 21   #end
22 22   #end
23 23  
24 - #if ("$!contactWebsite.trim()" != '')
25 - #set ($statusCode = 400)
26 - #set ($message = 'The request could not be sent. Please try again or contact Agnease by email.')
27 - #elseif ("$!name" == '' && "$!email" == '')
28 - #set ($statusCode = 400)
46 + #set ($spamScore = 0)
47 +
48 + ## Honeypot: real users should never fill this field.
49 + #if ("$!contactWebsite" != '')
50 + #set ($spamScore = $spamScore + 5)
51 + #end
52 +
53 + ## Submission timing check.
54 + #if ("$!startedAtRaw" == '')
55 + ## The field is expected from the real form, so missing it is suspicious.
56 + #set ($spamScore = $spamScore + 2)
57 + #else
58 + #set ($startedAt = $numbertool.toNumber($startedAtRaw))
59 + #if ("$!startedAt" == '')
60 + #set ($spamScore = $spamScore + 2)
61 + #else
62 + #set ($now = $datetool.systemDate.time)
63 + #set ($elapsed = $now - $startedAt)
64 +
65 + ## Reject very fast submissions.
66 + #if ($elapsed > 0 && $elapsed < 10000)
67 + #set ($spamScore = $spamScore + 3)
68 + #end
69 + #end
70 + #end
71 +
72 + ## Random-looking name: long single token.
73 + #if ($name.length() >= 16 && !$name.contains(' '))
74 + #set ($spamScore = $spamScore + 2)
75 + #end
76 +
77 + ## Random-looking project description: long single token.
78 + #if ($scope.length() >= 12 && !$scope.contains(' '))
79 + #set ($spamScore = $spamScore + 2)
80 + #end
81 +
82 + ## Suspicious email local part with many dots and tiny fragments.
83 + #set ($emailParts = $email.split('@'))
84 + #if ($emailParts.size() == 2)
85 + #set ($localPart = $emailParts[0])
86 + #set ($localFragments = $localPart.split('\.'))
87 + #set ($dotCount = $localFragments.size() - 1)
88 + #set ($oneCharFragments = 0)
89 +
90 + #foreach ($fragment in $localFragments)
91 + #if ($fragment.length() == 1)
92 + #set ($oneCharFragments = $oneCharFragments + 1)
93 + #end
94 + #end
95 +
96 + #if ($dotCount >= 4 && $oneCharFragments >= 3)
97 + #set ($spamScore = $spamScore + 2)
98 + #end
99 + #else
100 + #set ($spamScore = $spamScore + 2)
101 + #end
102 +
103 + ## Human-facing validation.
104 + #if ("$!name" == '' && "$!email" == '')
29 29   #set ($message = 'Please enter your name and email.')
30 30   #elseif ("$!name" == '')
31 - #set ($statusCode = 400)
32 32   #set ($message = 'Please enter your name.')
33 33   #elseif ("$!email" == '')
34 - #set ($statusCode = 400)
35 35   #set ($message = 'Please enter your email address.')
110 + #elseif ("$!scope" == '' || $scope.length() < 30)
111 + #set ($message = 'Please add a short description of your XWiki project, question or issue.')
112 + #elseif ($spamScore >= 3)
113 + #set ($message = 'The request could not be sent. Please add a clearer description of your XWiki request or contact Agnease by email.')
36 36   #else
37 37   #try('contactException')
38 38   #set ($now = $datetool.get('yyyyMMddHHmm'))
... ... @@ -39,14 +39,66 @@
39 39   #set ($random = $mathtool.random(100000, 999999))
40 40   #set ($uniqueName = "ContactRequest-${now}-${random}")
41 41   #set ($contactRequestDoc = $xwiki.getDocumentAsAuthor('ContactRequests.' + $uniqueName))
42 - #set ($contactRequestObj = $contactRequestDoc.getObject('Agnease.Code.ContactRequest.ContactRequestClass', true))
120 + #set ($contactRequestObj = $contactRequestDoc.getObject($className, true))
43 43  
122 + ## Save only known ContactRequest fields.
44 44   #foreach ($parameterName in $request.parameterNames)
45 - #set ($propertyName = $parameterName.split('_0_')[1])
46 - #set ($discard = $contactRequestObj.set($propertyName, $request.get($parameterName)))
124 + #if ($parameterName == 'sourcePage')
125 + #set ($discard = $contactRequestObj.set($parameterName, $stringtool.trim($request.get($parameterName))))
126 + #end
127 + #set ($propertyParts = $parameterName.split('_0_'))
128 + #if ($propertyParts.size() > 1)
129 + #set ($propertyName = $propertyParts[1])
130 +
131 + #if ($allowedProperties.contains($propertyName))
132 + #set ($discard = $contactRequestObj.set($propertyName, $stringtool.trim($request.get($parameterName))))
133 + #end
134 + #end
47 47   #end
48 48  
49 49   #set ($discard = $contactRequestDoc.saveAsAuthor())
138 + ## Send internal notification email.
139 + ## This is intentionally best-effort: if email fails, the contact request is still saved.
140 + #try('mailException')
141 + #set ($notificationRecipient = 'alex@agnease.com')
142 + #set ($notificationSubject = 'New Agnease contact request')
143 + #set ($notificationBody = "
144 + Name:
145 + $!contactRequestObj.getValue('name')
146 +
147 + Email:
148 + $!contactRequestObj.getValue('email')
149 +
150 + Source page:
151 + $!contactRequestObj.getValue('sourcePage')
152 +
153 + Already uses XWiki:
154 + $!contactRequestObj.get('alreadyUseXWiki')
155 +
156 + Hosting:
157 + $!contactRequestObj.get('hosting')
158 +
159 + Custom development:
160 + $!contactRequestObj.get('customDevelopment')
161 +
162 + Timeline:
163 + $!contactRequestObj.get('timeline')
164 +
165 + Users:
166 + $!contactRequestObj.get('users')
167 +
168 + Message:
169 + $!contactRequestObj.getValue('scope')
170 +
171 + Internal request page:
172 + $contactRequestDoc.getExternalURL()
173 + ")
174 +
175 + #set ($message = $services.mail.sender.createMessage($notificationRecipient, $notificationSubject))
176 + #set ($discard = $message.setType('Agnease Contact Request'))
177 + #set ($discard = $message.addPart('text/plain', $notificationBody))
178 + #set ($mailResult = $services.mail.sender.sendAsynchronously([$message], 'database'))
179 + #end
50 50   #set ($statusCode = 200)
51 51   #set ($message = 'Your request was successfully sent.')
52 52   #end
... ... @@ -78,28 +78,31 @@
78 78   ## As a measure to avoid high load on website.
79 79   Tell us more about your project at <a href="mailto:alex@agnease.com">alex@agnease.com</a>
80 80   #else
211 + #set ($hiddenProperties = ['sourcePage'])
81 81   <form id="contactForm">
82 82   <dl>
83 83   #foreach ($property in $xclass.properties)
84 - #if ($property.name == 'hosting')
85 - <hr>
86 - <h3>Optional project details</h3>
87 - <p>These details help us understand the scope and suggest practical next steps.</p>
215 + #if (!$hiddenProperties.contains($property.name))
216 + #if ($property.name == 'hosting')
217 + <hr>
218 + <h3>Optional project details</h3>
219 + <p>These details help us understand the scope and suggest practical next steps.</p>
220 + #end
221 + <dt #if (!$editing && $hasEdit)
222 + class="editableProperty"
223 + #set ($xobjectPropertyReference = $xobject.getPropertyReference($property.name))
224 + data-property="$escapetool.xml($services.model.serialize($xobjectPropertyReference))"
225 + data-property-type="object"#end>
226 + ## This must match the id generated by the $doc.display() method below.
227 + #set ($propertyId = "${xclass.name}_${xobject.number}_$property.name")
228 + <label#if ($editing) for="$escapetool.xml($propertyId)"#end>
229 + $escapetool.xml($property.translatedPrettyName)
230 + </label>
231 + ## Support for specifying a translation key as hint in the property definition.
232 + <span class="xHint">$!escapetool.xml($services.localization.render($property.hint))</span>
233 + </dt>
234 + <dd>$doc.display($property.name, 'edit').replace('{{html clean="false" wiki="false"}}', '').replace("{{/html}}", '')</dd>
88 88   #end
89 - <dt #if (!$editing && $hasEdit)
90 - class="editableProperty"
91 - #set ($xobjectPropertyReference = $xobject.getPropertyReference($property.name))
92 - data-property="$escapetool.xml($services.model.serialize($xobjectPropertyReference))"
93 - data-property-type="object"#end>
94 - ## This must match the id generated by the $doc.display() method below.
95 - #set ($propertyId = "${xclass.name}_${xobject.number}_$property.name")
96 - <label#if ($editing) for="$escapetool.xml($propertyId)"#end>
97 - $escapetool.xml($property.translatedPrettyName)
98 - </label>
99 - ## Support for specifying a translation key as hint in the property definition.
100 - <span class="xHint">$!escapetool.xml($services.localization.render($property.hint))</span>
101 - </dt>
102 - <dd>$doc.display($property.name, 'edit').replace('{{html clean="false" wiki="false"}}', '').replace("{{/html}}", '')</dd>
103 103   #end
104 104   #if (!$xclass.properties || $xclass.properties.size() == 0)
105 105   ## Keep the empty definition term in order to have valid HTML.
... ... @@ -112,7 +112,7 @@
112 112   <div class="contact-hp-wrapper" aria-hidden="true">
113 113   <label for="Agnease.Code.ContactRequest.ContactRequestClass_0_contactWebsite">Website</label>
114 114   <input
115 - id="contactWebsite"
248 + id="Agnease.Code.ContactRequest.ContactRequestClass_0_contactWebsite"
116 116   type="text"
117 117   name="Agnease.Code.ContactRequest.ContactRequestClass_0_contactWebsite"
118 118   autocomplete="off"
... ... @@ -119,6 +119,8 @@
119 119   tabindex="-1"
120 120   />
121 121   </div>
255 + <input type="hidden" name="Agnease.Code.ContactRequest.ContactRequestClass_0_contactStartedAt" value="$datetool.systemDate.time" />
256 + <input type="hidden" name="sourcePage" />
122 122   <input id="contactSubmit" type="submit" class="btn btn-primary" value="Send my request">
123 123   </form>
124 124   #end
... ... @@ -139,9 +139,13 @@
139 139   {{/html}}
140 140   {{html clean="false"}}
141 141   </div>
142 - <div class="col-md-5">
143 - <div class="widget">
144 - <h4>$services.icon.renderHTML('check') How Agnease can help</h4>
277 + <div class="col-md-5 contact-side-panel">
278 + <div class="split-copy contact-help-panel">
279 + <h2>
280 + <i class="fa fa-check-circle" aria-hidden="true"></i>
281 + How Agnease can help
282 + </h2>
283 +
145 145   <ul>
146 146   <li>XWiki upgrades and long-term maintenance</li>
147 147   <li>Knowledge bases, intranets, SOP and documentation workflows</li>
... ... @@ -151,14 +151,21 @@
151 151   <li>Security-aware reviews and platform stabilization</li>
152 152   </ul>
153 153   </div>
154 - <div class="widget">
155 - <h4>$services.icon.renderHTML('right') What happens next?</h4>
156 - <ol>
157 - <li>Your request is reviewed.</li>
158 - <li>You receive a reply with clarifying questions or suggested next steps.</li>
159 - <li>If useful, we schedule a short call to discuss scope, timeline, and estimated effort.</li>
160 - </ol>
161 - </div>
293 +
294 + <ol class="process-list contact-process-list">
295 + <li>
296 + <strong>Your request is reviewed</strong>
297 + The project description is checked to understand the context and initial scope.
298 + </li>
299 + <li>
300 + <strong>You receive a reply</strong>
301 + Agnease replies with clarifying questions or suggested next steps.
302 + </li>
303 + <li>
304 + <strong>A short call can be scheduled</strong>
305 + If useful, we discuss scope, timeline and estimated effort together.
306 + </li>
307 + </ol>
162 162   </div>
163 163   </div>
164 164  {{/html}}
XWiki.StyleSheetExtension[0]
code
... ... @@ -1,71 +1,17 @@
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 70  .contact-hp-wrapper {
71 71   position: absolute;
... ... @@ -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,32 @@
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 + .replace(/\//g, '.');
24 +
25 + if (sourcePage) {
26 + sourcePageField.val(sourcePage);
27 + }
28 + } catch (e) {
29 + // Ignore invalid referrer values.
30 + }
31 + });
32 +});
name
... ... @@ -1,0 +1,1 @@
1 +document referrer catcher
use
... ... @@ -1,0 +1,1 @@
1 +currentPage