Setting up Geeklog on Mac OS X

Wednesday, March 02 2005 @ 04:02 PM EST

Contributed by: Admin

Here's my guide to setting up Geeklog (1.3.11) on Mac OS X (non-Server, OS X 10.3.7). It's a bit thin but it hits all the high points. Consider this an OS X-specific 'cheat-sheet' addition to the mostly excellent included documentation.

Getting Started

Download and install PHP

Install MySQL

unpack geeklog-1.3.11.tar.gz

You will see the following files:

-rw-r--r--   1 admin  staff    198 31 Dec 11:03 INSTALL
drwxr-xr-x   3 admin  staff    102 31 Dec 11:03 backups
-rw-r--r--   1 admin  staff  35242 31 Dec 11:03 config.php
drwxr-xr-x   3 admin  staff    102 31 Dec 11:03 data
-rwxr-xr-x   1 admin  staff    509 31 Dec 11:03 emailgeeklogstories
drwxr-xr-x  40 admin  staff   1360 31 Dec 11:03 language
drwxr-xr-x   4 admin  staff    136 31 Dec 11:03 logs
drwxr-xr-x   6 admin  staff    204 31 Dec 11:03 plugins
drwxr-xr-x  27 admin  staff    918 31 Dec 11:03 public_html
-rw-r--r--   1 admin  staff   4018 31 Dec 11:03 readme
drwxr-xr-x   4 admin  staff    136 31 Dec 11:03 sql
drwxr-xr-x  15 admin  staff    510 31 Dec 11:03 system

Move the contents of 'public_html' into ~/Sites/ or /Library/WebServer/Documents/. (The rest of these notes assume you're serving from your home directory.)

Move rest into new directory like ~/geeklog-admin/

Part 1: Database Setup

Using phpMyAdmin, create a new empty database called 'geeklog'

Part 2: filesystem setup

- cd ~/geeklog-admin/
chmod -R 777 logs
chmod -R 777 data
cp config.php config.php.orig
edit config.php as needed: paths, etc.

- cd ~/Sites/
chmod 777 backend/geeklog.rdf
chmod 777 images/userphotos/
chmod 777 images/articles/

Part 3: docroot files

cd ~/Sites/
Edit lib-common.php--skip down to around line 70 and specify the path to config.php.

Part 4: web-based setup


Oops! If you're doing this in OS X 10.3, the site probably isn't working. You probably just saw a message saying "An SQL error has occured. Please see error.log for details."
As per,
change line ~488 in ~/geeklog-admin/config-php around to
$_CONF['hidenewcomments'] = 1;

Part 5: Final steps

Filesystem: delete ~/Sites/admin/install/
Accounts: set new passwords for admin & moderator
- change password and email with 'account information' link
- log in and log out to make sure new info sticks

Part 6: Cleanup

Log in as admin
delete submissions (2) and stories (1) and links (1) and polls (1)
Blocks: season to taste

Download themes and unzip into ~/tmp/
My favorite theme--the one you're looking at now--is called 'clean.' I have slightly customized it. How? I'm glad you asked...
(Note that, UNIX-wise, they may not be the cleanest commands ever, but they work.)
mkdir ~/Sites/layout/your-theme-name
cp -r tmp/layout/clean/* ~/Sites/layout/your-theme-name/
Change theme name (around line 200 of config.php) to your-theme-name

New logo: ~/Sites/layout/apple/theme-images/clean-sitelogo.gif

New topic icons: 48x48, copy to ~/Sites/images/topics/ or icons/