Sapling Help

« Back to Sapling

Tip: Make sure you edit the content inside "index.html" as well as the content inside the "mobile" folder which is what users without Flash installed or who are visiting the site on mobile devices will see. If you don't remember to edit it, the name "Isabel Designostrom" will appear which you probably don't want.

These questions are ordered by how common they are - most common at the top. Please note the question numbers may change since I am constantly updating this section.

1. I just downloaded this - how do I get started?

   First open up "index.html" in your web browser - this is the main file that holds the site. Then open up "settings.xml". Make changes to the settings and refresh "index.html" to see the results of your changes.

2. My site suddenly stopped working after I made changes to my XML file. What do I do?

   Your XML file is probably malformed, meaning there is a typo/mistake in it somewhere that is stopping the web browser from reading it correctly. It is most likely a very simple fix - you just need to find where you made the error. An easy way to do that is to navigate to your XML file in your web browser. For example, if your site is named "yoursite.com" then navigate to this URL:

   http://www.yoursite.com/settings.xml

   In Firefox, the page will say something like:

   This page contains the following errors:

   error on line 1 at column 5: error parsing attribute name

   Usually that will give you enough info to locate your error. If you still have trouble, post a question in the forums and I can help you.

3. Nothing is happening when I open "index.html" or I am getting the message "Adobe Flash Player has stopped a potentially unsafe operation". How do I fix this?

   This is due to a security restriction in the Flash Player when loading XML files locally. Read more about it here, here and here if you want a technical explanation, otherwise just follow the below steps:

   1. Click the "Settings..." button on the warning popup or visit this link
   2. In the "Flash Player Global Security Settings" dialog box, select "Add location" from the "Edit locations..." drop down
   3. Click "Browse for folder..." and select the folder where your project is located
   4. Click Confirm

4. I'm on a PC and am using Notepad to edit the XML files. Everything looks bad and runs together. What can I do?

   If you don't own Dreamweaver or any other HTML editor then I recommend downloading and using Notepad++ to edit the XML files. It's free and I've heard good things about it.

5. How do I use my own logo?

   Open up "settings.xml" and set "useOwnLogo" to "true". Then set "logoFilePath" to the path to your logo. Additionally, you can tweak the positioning of the logo by editing "ownLogoXOffset" so everything lines up how you want.

6. How do I change the page title at the top of the browser window?

   The page title is set at the top of "index.html" between the "title" tags.

7. How can I control whether my links open in a new window or the same window?

   In "settings.xml" set the target part of your link tag to "_blank" to open links in a new window, like shown below:

   <link text="VISIT ME ON LINKEDIN" url="http://www.warmforestflash.com/" target="_blank" />

   To open in the same window set it to "_self", like shown below:

   <link text="VISIT ME ON LINKEDIN" url="http://www.warmforestflash.com/" target="_self" />

   If you don't want the link to do anything (like an email address you want to be able to copy and paste) set the url to a blank set of quotes, like shown below:

   <link text="HELLO@ISABELDESIGNOSTROM.COM" url="" />

8. Is there a any way I can purchase the source code for Sapling?

   Since several customers have asked for it, I've decided to offer the Sapling source code for $19. Purchase Sapling with this link.

9. When trying to view my site I keep seeing the message "Your Flash Player needs to be upgraded". What do I do?

   If you are seeing this message that means you haven't uploaded all of the required files. Everything in the demo/deploy folder needs to be uploaded in order for everything to work. Double check that the folder named "js" is uploaded to the root directory of your site. A lot of times people experience this problem because they haven't unzipped the files correctly. On a Mac you just double click the zip file to unzip. On a PC depending on your operating system you may need an unzip utility. See here for more info on opening zip files.

10. How do I setup the iPhone/iPad/iPod touch/non-Flash/mobile version of my site?

    1) Open up the "index.html" file from the root folder of your site in your favorite text editor. Scroll down and edit the HTML content. Basically change the name from "Isabel Designostrom" to your own and edit the email address and links and add whatever other content you want. This is the content that users will see who don't have the Flash plugin installed, although iPhone/iPad/iPod touch users won't see this and will be automatically forwarded to the mobile version described in step 2 below.

    2) Open up the folder named "mobile". This contains the iPhone/iPad/iPod touch/non-Flash/mobile version of your site. There is another "index.html" file in here that you will want to edit and add your content to. Also you will want to change the images in the "images" folder.

    3) You'll notice there is an image called "iphone_icon_57x57.png" in the "mobile" folder. This is the icon that is displayed if a user adds a link to your site from the home screen on their iPhone/iPad (sort of like a fav icon). To change this image you'll want to create a PNG sized 57x57. You don't need to create any rounded corners or the shine effect - those are added automatically by the iPhone. If you don't want a custom icon you can just delete that image and open "index.html" and delete this line at the top:

    <link rel="apple-touch-icon" href="iphone_icon_57x57.png" />

    After that you should be all set with your new mobile site!

11. I purchased a template awhile ago before it came with a iPhone/iPad/iPod touch/non-Flash/mobile version, is there a way I can still get the mobile version?

    Yes, you can download the files you need here, then follow these simple instructions:

    1) From the ZIP file you just downloaded, drag the folder named "mobile" into your demo/deploy folder (the one that contains all the SWF files and "index.html").

    2) Rename your current "index.html" file to "index_old.html".

    3) Drag the correct HTML file from the ZIP file to where your "index.html" file was and rename it "index.html". For example if you are using the Aspen template, drag over the file named "aspen.html" and rename it "index.html".

    4) Open up your new "index.html" file and the "index.html" from the mobile folder in your favorite text editor and edit the content and you should be good to go. For additional tips see the question above.

12. I noticed on your personal site using Cedar (www.jeremiahshoaf.com) you have it setup so when you view it on an iPhone it automatically goes to the address "m.jeremiahshoaf.com". How did you set that up?

    The "m.yourdomain.com" setup seems to becoming the standard way of delivering a mobile site. To set something like that up you'll need to create a new subdomain on your webserver named "m". Contact your web host for instructions on how to do this. It's fairly easy but varies from host to host. After that you will want to change the URL that the site forwards to. Do this by opening up the "index.html" file in your root folder and make the following edits:

    Look for this line at the top:

    document.location = "mobile/";

    And change it to the following:

    document.location = "http://m.yourdomain.com";

    Then look for this line towards the bottom:

    <a href="mobile/">Visit a non-Flash version of my website</a>

    And change it to the following:

    <a href="http://m.yourdomain.com">Visit a non-Flash version of my website</a>

13. Any other questions?

    Please post in the forums and I'll answer any other questions you might have.