Wiki source code of Get in Touch About Your XWiki Project
Version 18.18 by Alex Cotiuga on 2026/07/09 20:30
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | {{velocity wiki="false"}} | ||
| 2 | #if ($xcontext.action == 'get') | ||
| 3 | #set ($statusCode = 400) | ||
| 4 | #set ($message = 'The request could not be sent. Please try again or contact Agnease by email at alex@agnease.com.') | ||
| 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 | |||
| 19 | #set ($name = '') | ||
| 20 | #set ($email = '') | ||
| 21 | #set ($scope = '') | ||
| 22 | #set ($contactWebsite = '') | ||
| 23 | #set ($startedAtRaw = '') | ||
| 24 | #set ($sourcePage = '') | ||
| 25 | |||
| 26 | ## Extract only the values we need for validation. | ||
| 27 | #foreach ($parameterName in $request.parameterNames) | ||
| 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 | ||
| 44 | #end | ||
| 45 | #end | ||
| 46 | |||
| 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" == '') | ||
| 106 | #set ($message = 'Please enter your name and email.') | ||
| 107 | #elseif ("$!name" == '') | ||
| 108 | #set ($message = 'Please enter your name.') | ||
| 109 | #elseif ("$!email" == '') | ||
| 110 | #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.') | ||
| 115 | #else | ||
| 116 | #try('contactException') | ||
| 117 | #set ($now = $datetool.get('yyyyMMddHHmm')) | ||
| 118 | #set ($random = $mathtool.random(100000, 999999)) | ||
| 119 | #set ($uniqueName = "ContactRequest-${now}-${random}") | ||
| 120 | #set ($contactRequestDoc = $xwiki.getDocumentAsAuthor('ContactRequests.' + $uniqueName)) | ||
| 121 | #set ($contactRequestObj = $contactRequestDoc.getObject($className, true)) | ||
| 122 | |||
| 123 | ## Save only known ContactRequest fields. | ||
| 124 | #foreach ($parameterName in $request.parameterNames) | ||
| 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 | ||
| 137 | #end | ||
| 138 | |||
| 139 | #set ($discard = $contactRequestDoc.saveAsAuthor()) | ||
| 140 | #set ($statusCode = 200) | ||
| 141 | #set ($message = 'Your request was successfully sent.') | ||
| 142 | #end | ||
| 143 | |||
| 144 | #if ("$!contactException" != '') | ||
| 145 | #set ($statusCode = 400) | ||
| 146 | #set ($message = 'The request could not be sent. Please try again or contact Agnease by email.') | ||
| 147 | #end | ||
| 148 | #end | ||
| 149 | |||
| 150 | #set ($discard = $response.setStatus($statusCode)) | ||
| 151 | #jsonResponse({'message': $message}) | ||
| 152 | #end | ||
| 153 | {{/velocity}} | ||
| 154 | |||
| 155 | {{velocity}} | ||
| 156 | #set ($discard = $xwiki.ssx.use('contact.WebHome')) | ||
| 157 | #set ($xobject = $doc.getObject('Agnease.Code.ContactRequest.ContactRequestClass')) | ||
| 158 | #set ($totalRequests = $services.query.xwql('from doc.object(Agnease.Code.ContactRequest.ContactRequestClass) contact').execute()) | ||
| 159 | #set ($xclass = $xobject.xWikiClass) | ||
| 160 | #set ($editing = true) | ||
| 161 | = Tell Us More About Your Project = | ||
| 162 | You do not need to have a full specification. A short description is enough to start the conversation. | ||
| 163 | {{html clean="false"}} | ||
| 164 | You can also <a href="https://calendly.com/alex-agnease/30min?back=1&month=2026-06" target="_blank">book a free XWiki review call</a> to discuss your current setup. | ||
| 165 | <div class="row"> | ||
| 166 | <div class="xform col-md-7"> | ||
| 167 | #if ($totalRequests.size() > 50) | ||
| 168 | ## As a measure to avoid high load on website. | ||
| 169 | Tell us more about your project at <a href="mailto:alex@agnease.com">alex@agnease.com</a> | ||
| 170 | #else | ||
| 171 | #set ($hiddenProperties = ['sourcePage']) | ||
| 172 | <form id="contactForm"> | ||
| 173 | <dl> | ||
| 174 | #foreach ($property in $xclass.properties) | ||
| 175 | #set ($hiddenPropertiesCSS = '') | ||
| 176 | #if ($hiddenProperties.contains($property.name)) | ||
| 177 | #set ($hiddenPropertiesCSS = 'class="hidden"') | ||
| 178 | #end | ||
| 179 | #if ($property.name == 'hosting') | ||
| 180 | <hr> | ||
| 181 | <h3>Optional project details</h3> | ||
| 182 | <p>These details help us understand the scope and suggest practical next steps.</p> | ||
| 183 | #end | ||
| 184 | <dt $hiddenPropertiesCSS #if (!$editing && $hasEdit) | ||
| 185 | class="editableProperty" | ||
| 186 | #set ($xobjectPropertyReference = $xobject.getPropertyReference($property.name)) | ||
| 187 | data-property="$escapetool.xml($services.model.serialize($xobjectPropertyReference))" | ||
| 188 | data-property-type="object"#end> | ||
| 189 | ## This must match the id generated by the $doc.display() method below. | ||
| 190 | #set ($propertyId = "${xclass.name}_${xobject.number}_$property.name") | ||
| 191 | <label#if ($editing) for="$escapetool.xml($propertyId)"#end> | ||
| 192 | $escapetool.xml($property.translatedPrettyName) | ||
| 193 | </label> | ||
| 194 | ## Support for specifying a translation key as hint in the property definition. | ||
| 195 | <span class="xHint">$!escapetool.xml($services.localization.render($property.hint))</span> | ||
| 196 | </dt> | ||
| 197 | <dd $hiddenPropertiesCSS>$doc.display($property.name, 'edit').replace('{{html clean="false" wiki="false"}}', '').replace("{{/html}}", '')</dd> | ||
| 198 | #end | ||
| 199 | #if (!$xclass.properties || $xclass.properties.size() == 0) | ||
| 200 | ## Keep the empty definition term in order to have valid HTML. | ||
| 201 | <dt></dt> | ||
| 202 | <dd>$escapetool.xml($services.localization.render('xclass.defaultObjectSheet.noProperties'))</dd> | ||
| 203 | #end | ||
| 204 | </dl> | ||
| 205 | <p class="xHint">* Your information will only be used to respond to this request.</p> | ||
| 206 | ## Hidden fields to catch requests filled by bots. | ||
| 207 | <div class="contact-hp-wrapper" aria-hidden="true"> | ||
| 208 | <label for="Agnease.Code.ContactRequest.ContactRequestClass_0_contactWebsite">Website</label> | ||
| 209 | <input | ||
| 210 | id="Agnease.Code.ContactRequest.ContactRequestClass_0_contactWebsite" | ||
| 211 | type="text" | ||
| 212 | name="Agnease.Code.ContactRequest.ContactRequestClass_0_contactWebsite" | ||
| 213 | autocomplete="off" | ||
| 214 | tabindex="-1" | ||
| 215 | /> | ||
| 216 | </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}" /> | ||
| 219 | <input id="contactSubmit" type="submit" class="btn btn-primary" value="Send my request"> | ||
| 220 | </form> | ||
| 221 | #end | ||
| 222 | {{/html}} | ||
| 223 | {{html clean="false" wiki="true"}} | ||
| 224 | <div class="reviewNotifications"> | ||
| 225 | <div class="hidden reviewNotificationSuccess"> | ||
| 226 | |||
| 227 | {{success}}reviewNotification{{/success}} | ||
| 228 | |||
| 229 | </div> | ||
| 230 | <div class="hidden reviewNotificationError"> | ||
| 231 | |||
| 232 | {{error}}reviewNotification{{/error}} | ||
| 233 | |||
| 234 | </div> | ||
| 235 | </div> | ||
| 236 | {{/html}} | ||
| 237 | {{html clean="false"}} | ||
| 238 | </div> | ||
| 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 | |||
| 246 | <ul> | ||
| 247 | <li>XWiki upgrades and long-term maintenance</li> | ||
| 248 | <li>Knowledge bases, intranets, SOP and documentation workflows</li> | ||
| 249 | <li>Custom XWiki applications and integrations</li> | ||
| 250 | <li>LDAP, SSO, OIDC, SAML, and MFA setup</li> | ||
| 251 | <li>Migrations from SharePoint, Confluence, MediaWiki, or file-based documentation</li> | ||
| 252 | <li>Security-aware reviews and platform stabilization</li> | ||
| 253 | </ul> | ||
| 254 | </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> | ||
| 270 | </div> | ||
| 271 | </div> | ||
| 272 | {{/html}} | ||
| 273 | {{/velocity}} |