Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Any custom images that you wish to use in your Print Templates should reside in the WebApps\WebService\custom\print\templates\images folder and custom css in the WebApps\WebService\custom\print\templates\css folder.

Tip

If iShare GIS finds any Print Templates in the custom folder then it will ignore any in the base folder so, if you want to use any of those supplied by Astun you need to copy the ones you want into the custom folder. 


Below we have the A4-portrait.html which is a Portrait template for printing to A4 size.

...

  1. The ishare-edit-inline class must be added to the element.
  2. Content must contain ##name.default content## where name will be used to label the text input field in the Print Options dialog (with the first letter capitalised) and default content is the text that will be used without user intervention. The ## characters are required.

Content replacement

All the content of the element will be replaced by the default (and then the user input) text. Any text entered outside the ## characters will be ignored e.g.:

Code Block
languagexml
<span class="ishare-edit-inline">Here's some ##words.words on a page##, nice!</span>

will be altered on loading to:

...

languagexml

...

  1. E.g. in the default A4 Template we have

    Code Block
    <span id="title" class="ishare-edit-inline"

...

  1. >##title.Enter 

...

  1. map 

...

  1. title##</span>

    which

...

Custom text input

...

  1. shows as this under the Print Options:
    Image Added
    which the user may then change to whatever they want except, as the only form element used for text entry is the single-line <input> element,

...

  1. no line-breaks can be added to the text.

How this works

All the content of the element will be replaced by the default (and then the user input) text. Any text entered outside the ## characters will be ignored. All the content of the element will be replaced by the default (and then the user input) text.

Example 1 - How not to do it...

Code Block
languagexml
titleBad Example - Text inside <span not inside the ## will not be displayed
<span class="ishare-inline-edit">This document was produced for ##purpose.INSERT RECIPIENT##, please do not copy without permission.</span>

This will be altered on loading to:

Code Block
<span class="ishare-edit-inline">INSERT RECIPIENT</span>

And then will display as simply "INSERT RECIPIENT" on the map panel. The Text entry under Print Options will display as "Purpose: INSERT RECIPIENT".

Example 2 - Much better...

Any text you wish to display must be outside the <span> e.g.:

Code Block
languagexml
titleGood Example
This document was produced for <span class="ishare-inline-edit">##purpose.INSERT RECIPIENT##</span>, please do not copy without permission.

In the default A4 template above there is just the one

Validation

...

This will be altered on loading to:

Code Block
This document was produced for <span class="ishare-edit-inline">INSERT RECIPIENT</span>, please do not copy without permission.

This will correctly display as "This document was produce for INSERT RECIPIENT, please do not copy without permission. The Text entry under Print Options will display as "Purpose: INSERT RECIPIENT".

Predefined Dynamic Elements

...

ClassValueNotes
ishare-user
Current user and domainFormatted as: user@domain
ishare-timestamp
Current timeISO datetime format: e.g. 2018-03-23 14:37:39 
ishare-projection
The in-use map projection codeE.g.: EPSG:27700
ishare-attribution
Copyright taken from the base MapSource
ishare-scale
Current map scale
ishare-centre

ishare-centre-x
ishare-centre-y
Central co-ordinates of the current view of the map

Format for ishare-centre: x, y

Units are rounded to a number of decimal places dependent on the projection units: 5 for degrees; 3 for miles and kilometres; and 0 for everything else.

ishare-bbox

ishare-min-x
ishare-min-y
ishare-max-x
ishare-max-y
Corner co-ordinates of the current view of the map

Format for ishare-bbox: min-x min-y max-x max-y



See ishare-centre for rounding information.

Example

In the above screenshot we have added Projection and Base Map Copyright to the basic A4 Template. To add any to your map just extract the details from the following examples:

...