diff options
| -rw-r--r-- | blog/conf/general-example | 27 | ||||
| -rw-r--r-- | blog/conf/httpd.conf | 18 | ||||
| -rw-r--r-- | blog/conf/wp-config.php | 46 | ||||
| -rw-r--r-- | blog/web/.htaccess | 11 | ||||
| -rwxr-xr-x | blog/web/fcgi/php-basic | 3 | ||||
| -rw-r--r-- | blog/web/index.php | 6 | ||||
| -rw-r--r-- | notes/customisation.pod | 215 |
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. |