2.3 :: Using Wapple Canvas

Wapple Canvas is the premier tool for creating Mobile Internet Sites. If you are already using Canvas to build, including WAPL functionality in your site is easy.

WAPL can be used inside an existing Wapple Canvas site using a WAPL chunk.

WAPL Input

There are 3 ways to specify the WAPL to use for the current chunk.

• Use URL - enter a URL to a page that outputs WAPL


• Use A WAPL File - Create WAPL Files within Canvas. WAPL Files that you have created for the current site are displayed in the drop down


• Override with WAPL Markup - enter WAPL markup directly into the chunk

Hello World Example

Use URL

1. Go to Edit > Build > Pages and select the page you wish to edit.


2. Add a WAPL chunk to the page using either the Chunk Browser or by selecting WAPL directly from the drop down.


3. Expand the chunk to reveal it's options.


4. WAPL File option select 'Use URL'


5. WAPL file location URL field enter http://wapl.info/files/examples/hello_world_1.xml


6. Click 'Save' Icon

Use WAPL File

1. To create a WAPL file within Wapple Canvas go to Edit > Features > Wapl Files.


2. Select 'Add A WAPL File' on the left hand side.


3. Enter the name 'Hello World' and click the 'Add' icon.


4. A list of all your WAPL files will be displayed.


5. Expand the 'Hello World' item and enter the following WAPL markup into the 'Data' field:
   
   1.  <?xml version="1.0" encoding="UTF-8" ?>
   2.  <wapl xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="http://wapl.wapple.net/wapl.xsd">
   3.   <layout>
   4.   <easyChars>
   5.   <value>Hello World</value>
   6.   </easyChars>
   7.   </layout>
   8.  </wapl>
   Downloadlisting 2.3.a


6. Click the 'Save' icon.


7. Go to Edit > Build > Pages and select the page you wish to edit.


8. Add a WAPL chunk to the page using either the Chunk Browser or by selecting WAPL directly from the drop down.


9. Expand the chunk to reveal it's options.


10. WAPL File option select 'Hello World'


11. Click 'Save' Icon

Override with WAPL Markup

1. Go to Edit > Build > Pages and select the page you wish to edit.


2. Add a WAPL chunk to the page using either the Chunk Browser or by selecting WAPL directly from the drop down.


3. Expand the chunk to reveal it's options.


4. Enter the following WAPL markup into the 'Override with WAPL Markup' field:
   
   1.  <?xml version="1.0" encoding="UTF-8" ?>
   2.  <wapl xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="http://wapl.wapple.net/wapl.xsd">
   3.   <layout>
   4.   <easyChars>
   5.   <value>Hello World</value>
   6.   </easyChars>
   7.   </layout>
   8.  </wapl>
   Downloadlisting 2.3.a


5. Click 'Save' Icon


6. The chunk will use this markup instead of markup from a URL or WAPL File.