Drupal
Basic Assumptions
- This guide assumes you:
- Are not scared of CLI (and using bash)
- Will be using Drupal 6.x
- Have a little experience with websites
- Will be using /var/www for your source
- Will be using yoursite.com to refer to your site
- Were not offended here (we did say basic)
Drupal Installation
Grab the latest release from http://www.drupal.org
- Unpack inside /var/www (Move everything outside the drupal directory)
Create Database
- Create a database and database user
- Replace $database and $pass with appropriate values
- echo "CREATE DATABASE $database;" | mysql -uroot -p
- echo "GRANT ALL ON $database.* TO '$database'@'localhost' IDENTIFIED BY '$pass';" | mysql -uroot -p
Create Website
- Create website files (The Ubuntu Drupal team suggests using a multisite setup)
- cd /var/www/sites
- mkdir -p yoursite.com/{files,modules,themes}
- cp default/default.settings.php yoursite.com/settings.php
- chmod 777 yoursite.com/settings.php yoursite.com/files
- Grab the latest module/theme builds
Alternatively, you can grab a latest stable from the ubuntu-drupal project
- cd /var/www/sites/yoursite.com
- If you DO NOT have a Launchpad account:
bzr branch https://code.edge.launchpad.net/~ubuntu-drupal-modules/ubuntu-drupal-openid/6.x modules/openid
bzr branch https://code.edge.launchpad.net/~ubuntu-drupal-modules/ubuntu-drupal-launchpad/6.x modules/openid_launchpad
bzr branch https://code.edge.launchpad.net/~ubuntu-drupal-modules/ubuntu-drupal-teams/6.x modules/openid_teams
bzr branch https://code.edge.launchpad.net/~ubuntu-drupal-modules/drupal-planet/6.x modules/planet
bzr branch https://code.edge.launchpad.net/~ubuntu-drupal-themes/ubuntu-drupal-theme/6.x themes/ubuntu-loco
- bzr launchpad-login
- bzr branch lp:ubuntu-drupal-openid modules/openid
- bzr branch lp:ubuntu-drupal-launchpad modules/openid_launchpad
- bzr branch lp:ubuntu-drupal-teams modules/openid_teams
- bzr branch lp:drupal-planet modules/planet
- bzr branch lp:ubuntu-drupal-theme themes/ubuntu-loco
- Create entry in hosts file for loopback
echo "127.0.0.1 yoursite.com" >> /etc/hosts
Finish Installation
- Go to yoursite.com
- Perform a standard installation
- "Install Drupal in Language"
- Enter details from "Create Database" section"
- Toss in standard info
- Click "You may now visit your new site."
- Clean up permissions
- chmod 774 /var/www/sites/yoursite.com/*
Setup Site
- Go to yoursite.com/admin/build/modules
- Enable "OpenID" in "Core - optional" section
- Enable "Launchpad OpenID" in "Other" section
- Enable "OpenID Teams" in "Other" section
- Click "Save Configuration"
- Go to yoursite.com/admin/build/themes
- Select "Ubuntu-Loco" theme
- Click "Save Configuration"
- Go to admin/build/blocks
- Move the "Launchpad Login Button" underneath the "User Login" block.
- Disable to login block (after testing)
I usually set the "Block title" to "<none>"
NOTE: Defaults past this point should be acceptable.
- Go to yoursite.com/admin/settings/launchpad
- Verify server is set to production
- If you need your trust root added to Launchpad:
- Ensure this is the location you will keep your site at
Ask a question in Launchpad
- Go to yoursite.com/admin/settings/openid_teams
- If you have a Launchpad team, you can add it here and assign it to and existing role
- Go to yoursite.com/admin/user/settings
- Under "Launchpad user options"
- These settings are pretty self explanatory. Ask in channel if you don't understand them.
- Under "User registration settings"
- The Ubuntu Drupal team recommends using "Visitors can create accounts and no administrator approval is required."
- If your trust root is verified, there's no need for the "Require e-mail verification [...]" setting
- If your trust root is not verified, you should use the "Require e-mail verification [...]" setting
- Under "Launchpad user options"
Using The Modules
- Log out of the site
- Click the Launchpad Login button
- You will be transferred to Launchpad
- Sign in here
- IF your trust root IS NOT verified, you will need to provide an email address
- Your account will be created and you will be logged in
- Your Launchpad ID will be used as the user name of the account
- Your primary Launchpad email will be used