srdjanrosic / sietfstyle

README file for sietfstyle

Recommended configuration for testing this style:

You need to setup a local phpbb3 instance.
That requires a vhost and a database.
Note, that what is described here is neither secure nor recommended for an
actual production environment.


Step 1.
  Add the line:
    127.0.0.1 forum-test
  to your hosts file. Location depends on the OS.

  Windows:
   C:\Windows\System32\drivers\etc\hosts

  Linux, FreeBSD, OpenBSD, NetBSD, or toaster:
   /etc/hosts

  Solaris and OpenSolaris
   /etc/inet/hosts

  Mac OS X
   /private/etc/hosts


Step 2.
  Install Lighttpd.


Step 3.
  Install php5-fcgi.


Step 4.
  Install mysql


Step 5.
  Create a new directory and extract the latest stable phpBB3.
  This path will be your document root.


Step 6.
  Create mysql Database. You could use these commands to do it.

  Example:
    create database forumtest;
    grant all 
      on forumtest.* 
      to 'forum-test'@'localhost' 
      identified by 'forum-test';


Step 7.
  Configure Lighttpd to use php via fastcgi and serve forum-test vhost.

  Example, change the paths to match your document root, accesslog is optional:
    $HTTP["host"] == "forum-test" {
      server.document-root = "/var/www/forum-test/htdocs/"
      accesslog.filename   = "/var/www/forum-test/logs/access.log"
    }

  In addition you might need to setup php fastcgi, try adding this to the config:
    fastcgi.server                 = (
      ".php" => (
        (
          "bin-path"              => "/usr/bin/php-cgi",
          "socket"                => "/tmp/php.socket",
          "max-procs"             => 2,
          "idle-timeout"          => 20,
          "bin-environment"       => (
              "PHP_FCGI_CHILDREN"     => "4",
              "PHP_FCGI_MAX_REQUESTS" => "10000",
              # 2
          ),
          # 5
          "bin-copy-environment"  => ("PATH", "SHELL", "USER"),
          "broken-scriptfilename" => "enable",
          # 7
        ),
      ),
    )

Step 8.
  Go through phpbb3 web setup at
    http://forum-test/
  When asked for database details, use
    database client api: mysqli
    database host: forum-test
    database name: forumtest
    database username: forum-test
    database password: forum-test

Step 9.
  Checkout the style by executing this command within ${DOCUMENT_ROOT}/styles/
    git clone git://github.com/srdjanrosic/sietfstyle.git

  New style should be available for installation via phpbb administration panel.

Step 10.
  Hack test hack test. Use git. Hack test hack test. Use git.

  Once you think you're done with your changes send an email with the patch.
  A really really really helpful command for generating such a patch would be:
    git format-patch origin
  That will generate such an email's body.

  An alternative is to push your changes to a public repostory and send an email
about a push request.