Skip to Content
Last modified by Alex Cotiuga on 2026/07/27 06:09
From version 16.48
edited by Alex Cotiuga
on 2026/06/16 17:00
Change comment: There is no comment for this version
To version 18.15
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,50 +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 - ## Fields to help preventing bots filled forms.
21 + #set ($scope = '')
9 9   #set ($contactWebsite = '')
10 10   #set ($startedAtRaw = '')
24 + #set ($sourcePage = '')
11 11  
26 + ## Extract only the values we need for validation.
12 12   #foreach ($parameterName in $request.parameterNames)
13 13   #set ($propertyParts = $parameterName.split('_0_'))
14 14   #if ($propertyParts.size() > 1)
15 - #set ($propertyName = $parameterName.split('_0_')[1])
30 + #set ($propertyName = $propertyParts[1])
31 + #set ($propertyValue = $stringtool.trim($request.get($parameterName)))
32 +
16 16   #if ($propertyName == 'name')
17 - #set ($name = $stringtool.trim($request.get($parameterName)))
34 + #set ($name = $propertyValue)
18 18   #elseif ($propertyName == 'email')
19 - #set ($email = $stringtool.trim($request.get($parameterName)))
36 + #set ($email = $propertyValue)
37 + #elseif ($propertyName == 'scope')
38 + #set ($scope = $propertyValue)
20 20   #elseif ($propertyName == 'contactWebsite')
21 - #set ($contactWebsite = $stringtool.trim($request.get($parameterName)))
40 + #set ($contactWebsite = $propertyValue)
22 22   #elseif ($propertyName == 'contactStartedAt')
23 - #set ($startedAtRaw = $stringtool.trim($request.get($parameterName)))
42 + #set ($startedAtRaw = $propertyValue)
24 24   #end
25 25   #end
26 26   #end
27 27  
28 - #if ("$!startedAtRaw" != '')
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
29 29   #set ($startedAt = $numbertool.toNumber($startedAtRaw))
30 - #set ($now = $datetool.systemDate.time)
31 - #set ($elapsed = $now - $startedAt)
60 + #if ("$!startedAt" == '')
61 + #set ($spamScore = $spamScore + 2)
62 + #else
63 + #set ($now = $datetool.systemDate.time)
64 + #set ($elapsed = $now - $startedAt)
32 32  
33 - ## Reject submissions faster than 10 seconds.
34 - #if ($elapsed > 0 && $elapsed < 10000)
35 - #set ($statusCode = 400)
36 - #set ($message = 'Please take a moment to describe your XWiki request before submitting.')
66 + ## Reject very fast submissions.
67 + #if ($elapsed > 0 && $elapsed < 10000)
68 + #set ($spamScore = $spamScore + 3)
69 + #end
37 37   #end
38 - #elseif ("$!contactWebsite.trim()" != '')
39 - #set ($statusCode = 400)
40 - #set ($message = 'The request could not be sent. Please try again or contact Agnease by email.')
41 - #elseif ("$!name" == '' && "$!email" == '')
42 - #set ($statusCode = 400)
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" == '')
43 43   #set ($message = 'Please enter your name and email.')
44 44   #elseif ("$!name" == '')
45 - #set ($statusCode = 400)
46 46   #set ($message = 'Please enter your name.')
47 47   #elseif ("$!email" == '')
48 - #set ($statusCode = 400)
49 49   #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.')
50 50   #else
51 51   #try('contactException')
52 52   #set ($now = $datetool.get('yyyyMMddHHmm'))
... ... @@ -53,11 +53,22 @@
53 53   #set ($random = $mathtool.random(100000, 999999))
54 54   #set ($uniqueName = "ContactRequest-${now}-${random}")
55 55   #set ($contactRequestDoc = $xwiki.getDocumentAsAuthor('ContactRequests.' + $uniqueName))
56 - #set ($contactRequestObj = $contactRequestDoc.getObject('Agnease.Code.ContactRequest.ContactRequestClass', true))
121 + #set ($contactRequestObj = $contactRequestDoc.getObject($className, true))
57 57  
123 + ## Save only known ContactRequest fields.
58 58   #foreach ($parameterName in $request.parameterNames)
59 - #set ($propertyName = $parameterName.split('_0_')[1])
60 - #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
61 61   #end
62 62  
63 63   #set ($discard = $contactRequestDoc.saveAsAuthor())
... ... @@ -92,15 +92,20 @@
92 92   ## As a measure to avoid high load on website.
93 93   Tell us more about your project at <a href="mailto:alex@agnease.com">alex@agnease.com</a>
94 94   #else
171 + #set ($hiddenProperties = ['sourcePage'])
95 95   <form id="contactForm">
96 96   <dl>
97 97   #foreach ($property in $xclass.properties)
175 + #set ($hiddenPropertiesCSS = '')
176 + #if ($hiddenProperties.contains($property.name))
177 + #set ($hiddenPropertiesCSS = 'class="hidden"')
178 + #end
98 98   #if ($property.name == 'hosting')
99 99   <hr>
100 100   <h3>Optional project details</h3>
101 101   <p>These details help us understand the scope and suggest practical next steps.</p>
102 102   #end
103 - <dt #if (!$editing && $hasEdit)
184 + <dt $hiddenPropertiesCSS #if (!$editing && $hasEdit)
104 104   class="editableProperty"
105 105   #set ($xobjectPropertyReference = $xobject.getPropertyReference($property.name))
106 106   data-property="$escapetool.xml($services.model.serialize($xobjectPropertyReference))"
... ... @@ -113,7 +113,7 @@
113 113   ## Support for specifying a translation key as hint in the property definition.
114 114   <span class="xHint">$!escapetool.xml($services.localization.render($property.hint))</span>
115 115   </dt>
116 - <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>
117 117   #end
118 118   #if (!$xclass.properties || $xclass.properties.size() == 0)
119 119   ## Keep the empty definition term in order to have valid HTML.
... ... @@ -126,7 +126,7 @@
126 126   <div class="contact-hp-wrapper" aria-hidden="true">
127 127   <label for="Agnease.Code.ContactRequest.ContactRequestClass_0_contactWebsite">Website</label>
128 128   <input
129 - id="contactWebsite"
210 + id="Agnease.Code.ContactRequest.ContactRequestClass_0_contactWebsite"
130 130   type="text"
131 131   name="Agnease.Code.ContactRequest.ContactRequestClass_0_contactWebsite"
132 132   autocomplete="off"
... ... @@ -133,7 +133,8 @@
133 133   tabindex="-1"
134 134   />
135 135   </div>
136 - <input type="hidden" name="Agnease.Code.ContactRequest.ContactRequestClass_0_contactStartedAt" value="$datetool.getsystemDate.time" />
217 + <input type="hidden" name="Agnease.Code.ContactRequest.ContactRequestClass_0_contactStartedAt" value="$datetool.systemDate.time" />
218 + <input type="hidden" name="sourcePage" value="$!{request.sourcePage}" />
137 137   <input id="contactSubmit" type="submit" class="btn btn-primary" value="Send my request">
138 138   </form>
139 139   #end
... ... @@ -154,9 +154,13 @@
154 154   {{/html}}
155 155   {{html clean="false"}}
156 156   </div>
157 - <div class="col-md-5">
158 - <div class="widget">
159 - <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 +
160 160   <ul>
161 161   <li>XWiki upgrades and long-term maintenance</li>
162 162   <li>Knowledge bases, intranets, SOP and documentation workflows</li>
... ... @@ -166,14 +166,21 @@
166 166   <li>Security-aware reviews and platform stabilization</li>
167 167   </ul>
168 168   </div>
169 - <div class="widget">
170 - <h4>$services.icon.renderHTML('right') What happens next?</h4>
171 - <ol>
172 - <li>Your request is reviewed.</li>
173 - <li>You receive a reply with clarifying questions or suggested next steps.</li>
174 - <li>If useful, we schedule a short call to discuss scope, timeline, and estimated effort.</li>
175 - </ol>
176 - </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>
177 177   </div>
178 178   </div>
179 179  {{/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,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