Move customisation notes across.

7 files changed, 0 insertions, 326 deletions

diff --git a/blog/conf/general-example b/blog/conf/general-example
deleted file mode 100644
index dca1e9dcc..000000000
--- a/blog/conf/general-example
+++ /dev/null
@@ -1,27 +0,0 @@
-<?php
-/*
- * general-example:
- * Example values for the "general" config file.
- *
- * Configuration parameters, in PHP syntax. Configuration parameters are set
- * using the PHP define('OPTION_...', '...') function. Both perl and PHP code
- * parse this properly, so you can use comments and conditionals and whatnot,
- * but unless essential it's better to keep it simple....
- *
- * Copy this file to one called "general" in the same directory.  Or
- * have multiple config files and use a symlink to change between them.
- * 
- * Copyright (c) 2005 UK Citizens Online Democracy. All rights reserved.
- * Email: francis@mysociety.org; WWW: http://www.mysociety.org
- *
- * $Id: general-example,v 1.2 2010-01-28 00:47:37 francis Exp $
- * 
- */
-
-// MySQL database for FMSBLOG mySociety WordPress
-define('OPTION_FMSBLOG_DB_NAME', '');
-define('OPTION_FMSBLOG_DB_USER', '');
-define('OPTION_FMSBLOG_DB_PASS', '');
-define('OPTION_FMSBLOG_DB_HOST', '');
-define('OPTION_STAGING', '0');
-
diff --git a/blog/conf/httpd.conf b/blog/conf/httpd.conf
deleted file mode 100644
index 2f93bc3cc..000000000
--- a/blog/conf/httpd.conf
+++ /dev/null
@@ -1,18 +0,0 @@
-# Apache configuration for code.fixmystreet.com.
-#
-# Copyright (c) 2012 UK Citizens Online Democracy. All rights reserved.
-# Email: struan@mysociety.org; WWW: http://www.mysociety.org
-
-<Location /fcgi>
-    Options +ExecCGI
-    SetHandler fastcgi-script
-</Location>
-
-RewriteEngine on
-#RewriteLog /var/log/apache2/rewrite.log
-#RewriteLogLevel 5
-
-# PHP files can be referred without PHP
-RewriteCond %{DOCUMENT_ROOT}%{REQUEST_URI}.php -f
-RewriteRule /(.+) /$1.php [PT]
-
diff --git a/blog/conf/wp-config.php b/blog/conf/wp-config.php
deleted file mode 100644
index 38599b326..000000000
--- a/blog/conf/wp-config.php
+++ /dev/null
@@ -1,46 +0,0 @@
-<?php
-/** WordPress's config file **/
-/** http://wordpress.org/   **/
-
-// ** MySQL settings ** //
-if (!@include "../conf/general") {
-    if (!@include "../../conf/general") {
-        if (!@include "../../../conf/general") {
-            if (!@include(dirname(__FILE__) . "../../../conf/general")) {
-                print "Error including conf/general in wp-config.php on code.fixmystreet.com WordPress";
-                exit;
-            }
-        }
-    }
-}
-define('DB_NAME', OPTION_FMSBLOG_DB_NAME);     // The name of the database
-define('DB_USER', OPTION_FMSBLOG_DB_USER);     // Your MySQL username
-define('DB_PASSWORD', OPTION_FMSBLOG_DB_PASS); // ...and password
-define('DB_HOST', OPTION_FMSBLOG_DB_HOST);     // 99% chance you won't need to change this value
-
-// Change the prefix if you want to have multiple blogs in a single database.
-
-$table_prefix  = 'wp_';   // example: 'wp_' or 'b2' or 'mylogin_'
-
-// Change this to localize WordPress.  A corresponding MO file for the
-// chosen language must be installed to wp-includes/languages.
-// For example, install de.mo to wp-includes/languages and set WPLANG to 'de'
-// to enable German language support.
-define ('WPLANG', '');
-
-$toppath = $_SERVER['DOCUMENT_ROOT']; 
-$trimmed = rtrim($toppath, "blog/web");
-define('TOP_PATH', $trimmed);
-
-/* Stop editing */
-
-$server = DB_HOST;
-$loginsql = DB_USER;
-$passsql = DB_PASSWORD;
-$base = DB_NAME;
-
-define('ABSPATH', dirname(__FILE__).'/');
-
-// Get everything else
-require_once(ABSPATH.'wp-settings.php');
-?>
diff --git a/blog/web/.htaccess b/blog/web/.htaccess
deleted file mode 100644
index 8d2ba9aa2..000000000
--- a/blog/web/.htaccess
+++ /dev/null
@@ -1,11 +0,0 @@
-
-# BEGIN WordPress
-<IfModule mod_rewrite.c>
-RewriteEngine On
-RewriteBase /
-RewriteCond %{REQUEST_FILENAME} !-f
-RewriteCond %{REQUEST_FILENAME} !-d
-RewriteRule . /index.php [L]
-</IfModule>
-
-# END WordPress
diff --git a/blog/web/fcgi/php-basic b/blog/web/fcgi/php-basic
deleted file mode 100755
index f3034d9e2..000000000
--- a/blog/web/fcgi/php-basic
+++ /dev/null
@@ -1,3 +0,0 @@
-#!/bin/sh
-PHP_FCGI_CHILDREN=1 PHPRC=/etc/php5/fcgi exec /usr/bin/php5-cgi
-
diff --git a/blog/web/index.php b/blog/web/index.php
deleted file mode 100644
index fbc0ef37f..000000000
--- a/blog/web/index.php
+++ /dev/null
@@ -1,6 +0,0 @@
-<?php 
-
-# Copy of the lines from WP main index.php, so it can be in subdirectory
-define('WP_USE_THEMES', true);
-require('./wp/wp-blog-header.php');
-
diff --git a/notes/customisation.pod b/notes/customisation.pod
deleted file mode 100644
index a8de0f0e5..000000000
--- a/notes/customisation.pod
+++ /dev/null
@@ -1,215 +0,0 @@
-=head1 Customising FixMyStreet
-
-This document explains how to tailor the default installation of
-FixMyStreet to your requirements, including limiting the geographic
-area it accepts queries for and translating the text.
-
-It also includes information about how to change the design.
-
-=head1 OVERVIEW
-
-FixMyStreet implements a Cobrand system in order to allow customisation
-of the default behavior. The Cobrand is made up of a set of templates for
-the Cobrand and a Cobrand module that contains code that customises the
-way the Cobrand behaves. There are defaults for both of these so the
-Cobrand only needs to override things that are specific to it.
-
-Customisations should be implemented like this as this means that any
-upgrade to FixMyStreet will not overwrite your changes.
-
-For a cobrand to work then it should have the same name as your site,
-e.g if your site is www.FixMyPark.com then your Cobrand should be
-called FixMyPark.
-
-The default Cobrand is called Default.
-
-=head1 TEMPLATES
-
-Templates are found in the templates directory. Within that there are
-seperate directories for web templates and email templates. Under each
-of these there is a directory for each Cobrand. In our FixMyPark example
-this would be C<templates/web/fixmypark> for the web templates and
-C<templates/email/fixmypark> for the email templates.
-
-The full set of templates is stored in the default Cobrand and if no
-equivalent template is found in a Cobrand directory FixMyStreet will
-use the default template.
-
-By default, the Default cobrand uses the templates in
-C<templates/web/fixmystreet> that are used for the www.fixmystreet.com website.
-If you want to base your design off this, you can inherit from those templates,
-rather than the "bare bones" default ones.
-
-At a bare minimum you will probably want to copy the header and footer
-web templates found in C<templates/web/fixmystreet/header.html> and
-C<templates/web/fixmystreet/footer.html> into your Cobrand and make appropriate
-changes.
-
-The other template you should make your own version of is the FAQ which
-is in C<templates/web/fixmystreet/faq/faq-en-gb.html>
-
-=head1 CSS
-
-The CSS is stored in web/cobrands/ under which there are directories for Cobrands.
-The loading of the CSS is controlled by the header templates. Note that
-FixMyStreet uses SCSS and Compass to generate our CSS so there are no CSS files
-until C<bin/make_css> has been run.
-
-The CSS provided with FixMyStreet uses CSS3 media queries in a mobile first
-format order to adapt the layout to work on different devices.
-
-The CSS is structured into main files:
-
-=over
-
-=item base.css
-
-This contains all the styling for the content of the pages in a mobile sized browser.
-
-=item layout.css
-
-This contains all the styling for the content of the pages in a desktop sized browser.
-
-=item _colours.css
-
-This contains basic colour information, so you can easily make a site that
-looks different simply by copying these files to your own cobrand CSS
-directory, and changing the colours.
-
-=back
-
-=head1 Cobrand modules
-
-Much of the rest of the customisation takes place in the Cobrand modules. These
-are automatically loaded according to the current Cobrand and can be found in
-C<perllib/FixMyStreet/Cobrands/>. There is a default Cobrand ( Default.pm ) which
-all Cobrands should inherit from. A Cobrand module can then override any of the
-methods from the default Cobrand.
-
-FixMyStreet uses the hostname of the current request along with the contents
-of the C<ALLOWED_COBRANDS> config option to determine which cobrand to use.
-C<ALLOWED_COBRANDS> is a list of cobrand names with an optional hostname match.
-override. If there is no hostname override then the first cobrand name that
-matches all or part of the hostname of the current request is used. If there is
-a hostname override then that is compared against the hostname of the current
-request. For example if C<ALLOWED_COBRANDS> is
-
-    ALLOWED_COBRANDS:
-        - fixmypark_fr: 'fr.fixmypark'
-        - fixmypark
-
-then a request to www.fixmypark.com will use the fixmypark cobrand but a
-request to fr.fixmypark.com will use fixmypark_fr. If no Cobrand listed in
-C<ALLOWED_COBRANDS> matches then the default Cobrand will be used.
-
-This means you can provide multiple Cobrands for the site if you require, e.g.
-for providing different languages, and FixMyStreet will use the first match
-listed in C<ALLOWED_COBRANDS>.
-
-Many of the functions in the Cobrand module are used by FixMyStreet in the UK
-to allow the site to offer versions localised to a single authority and should
-not be needed for most installs. Listed below are the most useful options that
-can be changed.
-
-=over
-
-=item site_title
-
-This should be set to the name of your site.
-
-=item country
-
-This should be set to the two letter ISO code for the country your site is for.
-
-=item disambiguate_location
-
-This is used by the Geocoding module of FixMyStreet to constrain the area for
-which results are returned when locating an address. It should return a hash
-reference of parameters that are compatible with the arguments of the geocoding module
-you are using.
-
-At a most basic level it should limit it to the country you are in:
-
-    sub disambiguate_location {
-        return {
-            country => 'uk',
-        };
-    }
-
-You can limit it to a smaller area using bounding boxes to contrain the area
-that the geocoder will consider:
-
-    sub disambiguate_location {
-        return {
-            centre => '52.688198,-1.804966',
-            span   => '0.1196,0.218675',
-            bounds => [ 52.807793, -1.586291, 52.584891, -1.963232 ],
-        };
-    }
-
-The centre and span are used by the Google geocoding API and the bounds by
-Bing.
-
-Note that these areguments are only as good a limiting results as the API
-that they are used by.
-
-=item geocode_postcode
-
-This function is used to convert postcodes entered into a latitude and 
-longitude. If the text passed is not a valid postcode then an error should
-be returned. If you do not want to use postcodes and always use a geocoding
-service then always return an error.
-
-If the postcode is valid and can be converted then the return value should
-look like this:
-
-    return { latitude => $latitude, longitude => $longitude };
-
-If there is an error it should look like this:
-
-    return { error => $error_message };
-
-=item find_closest and find_closest_address_for_rss
-
-These are used to provide information on the closest street to the point of
-the address in reports and rss feeds or alerts.
-
-=item allow_photo_upload
-
-Return 0 to disable the photo upload field.
-
-=item allow_photo_display
-
-Return 0 to disable the display of uploaded photos.
-
-=item area_types
-
-If you are using MapIt alongside FixMyStreet this should return a
-list of the area type codes that the site will handle. This is used
-to filter the data returned from MapIt so that only appropriate areas are
-displayed.
-
-=item remove_redundant_councils
-
-This is used to filter out any overlapping jurisdictions from MapIt results
-where only one of the authorities actually has reponsability for the events
-reported by the site. An example would be be a report in a city where MapIt
-has an id for the city council and the state council but problems are only
-reported to the state. In this case you would remove the id for the city
-council from the results.
-
-=item short_name
-
-This is used to turn the full authority name returned by MapIt into a short
-name.
-
-=back
-
-=head1 Translations and Language
-
-The translations for FixMyStreet are stored as gettext files and the
-language for a Cobrand is set in the C<set_lang_and_domain> call of
-the Cobrand module.
-
-The templates use the C<loc> method to pass strings to gettext for
-translation.