Skip to Content
Last modified by Alex Cotiuga on 2026/07/27 06:09
From version 16.45
edited by Alex Cotiuga
on 2026/06/16 16:58
Change comment: There is no comment for this version
To version 18.24
edited by Alex Cotiuga
on 2026/07/09 20:40
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,40 +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 = '')
8 - ## Fields to help preventing bots filled forms.
21 + #set ($scope = '')
9 9   #set ($contactWebsite = '')
10 10   #set ($startedAtRaw = '')
11 11  
25 + ## 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])
29 + #set ($propertyName = $propertyParts[1])
30 + #set ($propertyValue = $stringtool.trim($request.get($parameterName)))
31 +
16 16   #if ($propertyName == 'name')
17 - #set ($name = $stringtool.trim($request.get($parameterName)))
33 + #set ($name = $propertyValue)
18 18   #elseif ($propertyName == 'email')
19 - #set ($email = $stringtool.trim($request.get($parameterName)))
35 + #set ($email = $propertyValue)
36 + #elseif ($propertyName == 'scope')
37 + #set ($scope = $propertyValue)
20 20   #elseif ($propertyName == 'contactWebsite')
21 - #set ($contactWebsite = $stringtool.trim($request.get($parameterName)))
39 + #set ($contactWebsite = $propertyValue)
22 22   #elseif ($propertyName == 'contactStartedAt')
23 - #set ($startedAtRaw = $stringtool.trim($request.get($parameterName)))
41 + #set ($startedAtRaw = $propertyValue)
24 24   #end
25 25   #end
26 26   #end
27 27  
28 - #if ("$!contactWebsite.trim()" != '')
29 - #set ($statusCode = 400)
30 - #set ($message = 'The request could not be sent. Please try again or contact Agnease by email.')
31 - #elseif ("$!name" == '' && "$!email" == '')
32 - #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" == '')
33 33   #set ($message = 'Please enter your name and email.')
34 34   #elseif ("$!name" == '')
35 - #set ($statusCode = 400)
36 36   #set ($message = 'Please enter your name.')
37 37   #elseif ("$!email" == '')
38 - #set ($statusCode = 400)
39 39   #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.')
40 40   #else
41 41   #try('contactException')
42 42   #set ($now = $datetool.get('yyyyMMddHHmm'))
... ... @@ -43,11 +43,21 @@
43 43   #set ($random = $mathtool.random(100000, 999999))
44 44   #set ($uniqueName = "ContactRequest-${now}-${random}")
45 45   #set ($contactRequestDoc = $xwiki.getDocumentAsAuthor('ContactRequests.' + $uniqueName))
46 - #set ($contactRequestObj = $contactRequestDoc.getObject('Agnease.Code.ContactRequest.ContactRequestClass', true))
120 + #set ($contactRequestObj = $contactRequestDoc.getObject($className, true))
47 47  
122 + ## Save only known ContactRequest fields.
48 48   #foreach ($parameterName in $request.parameterNames)
49 - #set ($propertyName = $parameterName.split('_0_')[1])
50 - #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
51 51   #end
52 52  
53 53   #set ($discard = $contactRequestDoc.saveAsAuthor())
... ... @@ -82,15 +82,20 @@
82 82   ## As a measure to avoid high load on website.
83 83   Tell us more about your project at <a href="mailto:alex@agnease.com">alex@agnease.com</a>
84 84   #else
169 + #set ($hiddenProperties = ['sourcePage'])
85 85   <form id="contactForm">
86 86   <dl>
87 87   #foreach ($property in $xclass.properties)
173 + #set ($hiddenPropertiesCSS = '')
174 + #if ($hiddenProperties.contains($property.name))
175 + #set ($hiddenPropertiesCSS = 'class="hidden"')
176 + #end
88 88   #if ($property.name == 'hosting')
89 89   <hr>
90 90   <h3>Optional project details</h3>
91 91   <p>These details help us understand the scope and suggest practical next steps.</p>
92 92   #end
93 - <dt #if (!$editing && $hasEdit)
182 + <dt $hiddenPropertiesCSS #if (!$editing && $hasEdit)
94 94   class="editableProperty"
95 95   #set ($xobjectPropertyReference = $xobject.getPropertyReference($property.name))
96 96   data-property="$escapetool.xml($services.model.serialize($xobjectPropertyReference))"
... ... @@ -103,7 +103,7 @@
103 103   ## Support for specifying a translation key as hint in the property definition.
104 104   <span class="xHint">$!escapetool.xml($services.localization.render($property.hint))</span>
105 105   </dt>
106 - <dd>$doc.display($property.name, 'edit').replace('{{html clean="false" wiki="false"}}', '').replace("{{/html}}", '')</dd>
195 + <dd $hiddenPropertiesCSS>$doc.display($property.name, 'edit').replace('{{html clean="false" wiki="false"}}', '').replace("{{/html}}", '')</dd>
107 107   #end
108 108   #if (!$xclass.properties || $xclass.properties.size() == 0)
109 109   ## Keep the empty definition term in order to have valid HTML.
... ... @@ -116,7 +116,7 @@
116 116   <div class="contact-hp-wrapper" aria-hidden="true">
117 117   <label for="Agnease.Code.ContactRequest.ContactRequestClass_0_contactWebsite">Website</label>
118 118   <input
119 - id="contactWebsite"
208 + id="Agnease.Code.ContactRequest.ContactRequestClass_0_contactWebsite"
120 120   type="text"
121 121   name="Agnease.Code.ContactRequest.ContactRequestClass_0_contactWebsite"
122 122   autocomplete="off"
... ... @@ -123,7 +123,8 @@
123 123   tabindex="-1"
124 124   />
125 125   </div>
126 - <input type="hidden" name="Agnease.Code.ContactRequest.ContactRequestClass_0_contactStartedAt" value="$datetool.getsystemDate.time" />
215 + <input type="hidden" name="Agnease.Code.ContactRequest.ContactRequestClass_0_contactStartedAt" value="$datetool.systemDate.time" />
216 + <input type="hidden" name="sourcePage" />
127 127   <input id="contactSubmit" type="submit" class="btn btn-primary" value="Send my request">
128 128   </form>
129 129   #end
... ... @@ -144,9 +144,13 @@
144 144   {{/html}}
145 145   {{html clean="false"}}
146 146   </div>
147 - <div class="col-md-5">
148 - <div class="widget">
149 - <h4>$services.icon.renderHTML('check') How Agnease can help</h4>
237 + <div class="col-md-5 contact-side-panel">
238 + <div class="split-copy contact-help-panel">
239 + <h2>
240 + <i class="fa fa-check-circle" aria-hidden="true"></i>
241 + How Agnease can help
242 + </h2>
243 +
150 150   <ul>
151 151   <li>XWiki upgrades and long-term maintenance</li>
152 152   <li>Knowledge bases, intranets, SOP and documentation workflows</li>
... ... @@ -156,14 +156,21 @@
156 156   <li>Security-aware reviews and platform stabilization</li>
157 157   </ul>
158 158   </div>
159 - <div class="widget">
160 - <h4>$services.icon.renderHTML('right') What happens next?</h4>
161 - <ol>
162 - <li>Your request is reviewed.</li>
163 - <li>You receive a reply with clarifying questions or suggested next steps.</li>
164 - <li>If useful, we schedule a short call to discuss scope, timeline, and estimated effort.</li>
165 - </ol>
166 - </div>
253 +
254 + <ol class="process-list contact-process-list">
255 + <li>
256 + <strong>Your request is reviewed</strong>
257 + The project description is checked to understand the context and initial scope.
258 + </li>
259 + <li>
260 + <strong>You receive a reply</strong>
261 + Agnease replies with clarifying questions or suggested next steps.
262 + </li>
263 + <li>
264 + <strong>A short call can be scheduled</strong>
265 + If useful, we discuss scope, timeline and estimated effort together.
266 + </li>
267 + </ol>
167 167   </div>
168 168   </div>
169 169  {{/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