FROG - Python Blogging software

How to install Frog?

NOTE: This page will soon be updated with better installation instructions and how to configure Frog. Please bear with me.

Needed ingredients:

• Python (2.3 or newer)
• Snakelets (1.41 or newer)
• Snakelets plugin package (needed: scheduler and sharedauth)
• Frog webapp
• FileMgr webapp (1.3 or newer -- optional, but nice to have)

Alternatively:

• Python (2.3 or newer)
• Frog complete setup (contains all of the rest)

Steps:

1. If you're upgrading from a previous version: see below!
2. If using the complete setup: extract and skip to step 7 below.
3. If using the separate components: install and configure Snakelets
4. extract Frog and put the frog webapp in the webapps dir of the Snakelets install
5. same with FileMgr if you want to install that one
6. extract the plugins package and copy the plugins in the Snakelets plugins directory (snakeserver/plugins)
7. Now, open the frog webapp init file (the "__init__.py" file in the "frog" webapp directory) and look for configItems. You can change various things there, before starting the server:
   • storage = the location where all data files are stored; files = the location of the directories with image files etc for easy linking. You have to create those two directories. The default is that they have to be in your snakelets server directory (where also serv.py is).
   • adminusers = the administrator users of the Frog server. Hover with your mouse to learn what each highlighted string is:
     { "admin": LoginUser("admin","admin",name="Frog Admin", privileges=["admin"]) }
NOTICE: The USER NAME must be DIFFERENT from a user name that you plan to use as a normal Frog user!
   • rootdiruser = the blog user name when you want to directly access a blog when going to the frog application root url.
   • site-admin-name and site-admin-contact = two strings that appear on the about page.
   • mail server settings.
8. Check the filemgr's config file.
9. Start the Snakelets server.
10. Point your browser to http://yourserver:9080/frog/
    (this assumes that you use the default Snakelets port and no server url prefix)
11. You'll see Frog's welcome page. Go to the admin pages to create one or more blog users. The default admin login is "admin" password "admin" (if you didn't change it in the config step above).
12. Point your browser to http://yourserver:9080/frog/username/ to see the blog page of user username.
13. Have fun :-)

Upgrading from a previous version

Sometimes a new Frog version requires a data storage format conversion.

1. Just erase the old Frog webapp (but keep your blogdata/blogfiles directories, and copy the webapp's init file to a safe place!!) and install the new one in place. Edit the webapp config file so that the changes you made are again in it.
2. Log in as adminstrator and select "convert data from older version". Click the button. Repeat until version is current.
3. Use Frog as described above.
4. If you try to access Frog before you converted the storage format, it will give an exception or simply state that there are no users yet.

Contact me if you have any problems, questions, suggestions... Thank you!