• Welcome
• User Guide

  Getting started

  Setting up Dragonfly

  Working locally

  The .htaccess file

  Routes

  Default routes

  Creating your own routes

  Templates

  Creating templates and views

  Handling errors using templates

  Important Globals

  $GET $POST $FILES $COOKIES

  DF_SELF DF_SELF_DIR DF_PAGE

  Plugins

  Using and creating plugins

  List of included plugins

  Changes

  Changes between versions

  API Reference

  Core API

  Dragonfly DB

  Dragonfly SMTP

• Examples

  Tables

  Generate tables from lists

  Feeds

  How to read feeds from other websites

  AJAX

  Some simple AJAX calls

  Twitter

  Using Twitter with Dragonfly

  SEO Experiments

  Experiments in SEO

  Useful information

  Dragonfly debugging information

• Code
• About

Dragonfly in Non-Root

Say you want to test Dragonfly out by placing the entire directory into the root of your site. As an example the demo site could be located here:

/home/user/mysite.com/dragonfly/example-site/

And to access it you would use this URL:

http://www.mysite.com/dragonfly/example-site

Step 1: Update the .htaccess file

The .htaccess file is a hidden file located inside the example-site folder.
Change this line in .htaccess:

RewriteBase /

To:

RewriteBase /dragonfly/example-site/

Step 2: Update Dragonfly's configuration

In example-site/dragonfly-framework you'll find the file config.lsp.
Change this line:

(constant (global 'DOCUMENT_ROOT) (env "DOCUMENT_ROOT"))

To:

(constant (global 'DOCUMENT_ROOT)
          "/home/user/mysite.com/dragonfly/example-site")

Step 3 (optional): newLISP outside from /usr/bin/

A possible third step is required if your newlisp binary is NOT installed in /usr/bin/newlisp.

If it's installed somewhere else (for example: /path/to/bin/newlisp), then you may need to also edit index.cgi file and change the top line from:

#!/usr/bin/env newlisp

To:

#!/path/to/bin/newlisp