Fix some syntax and add more content

Author: MrTango

docs/backend/global-utils.md

@@ -3,7 +3,7 @@ html_meta:
   "description": "Global functions defined in CMFPlone and plone.app.layout."
   "property=og:description": "Global functions defined in CMFPlone and plone.app.layout."
   "property=og:title": "Global utils and helpers"
-  "keywords": "global variables,portal_state,context_state,plone_view,portal_url,helper methods"
+  "keywords": "Plone, Classic UI, templates, global variables, portal_state, context_state, plone_view, portal_url, helper methods"
 ---
 
 

docs/classic-ui/templates-global-variables.md

@@ -10,12 +10,49 @@ html_meta:
 
 For convenience Plone defines a couple of global variables often used in templates.
 
-- [`portal_state`](backend-global-utils-portal-state-label)
-- [`context_state`](backend-global-utils-context-state-label)
-- [`plone_view`](backend-global-utils-plone-view-label)
-- `icons`
+- {ref}`backend-global-utils-portal-state-label`
+- {ref}`backend-global-utils-context-state-label`
+- {ref}`backend-global-utils-plone-view-label`
+- {ref}`icons <classic-ui-icons-icon-resolver-label>`
 - `lang`
-- `portal_url`
-- `checkPermission`
+- {ref}`classic-ui-templates-global-variables-portal-url-label`
+- {ref}`classic-ui-templates-global-variables-check-permissions`
 - `ajax_include_head`
 - `isAnon`
+
+
+(classic-ui-templates-global-variables-portal-url-label)=
+
+## `portal_url`
+
+`portal_url` will return the portal URL.
+It can be used as follows:
+
+```xml
+<a href="${portal_url}/@@overview-controlpanel>Overview Controlpanel</a>
+```
+
+It is basically a short cut for:
+
+```xml
+<div tal:define="portal_url python: portal_state.portal_url()">
+  <a href="${portal_url}/@@overview-controlpanel">Overview Controlpanel</a>
+</div>
+```
+
+
+(classic-ui-templates-global-variables-check-permissions)=
+
+## `checkPermission`
+
+`checkPermission` will return the checkPermission method from portal_membership tool.
+
+It can be used as follows to check for user permissions in templates:
+
+```xml
+<div tal:condition="python: checkPermission('Modify portal content', context)">
+  <span tal:omit-tag="">
+    You see this page because you have permission to edit this.
+  </span>
+</div>
+```