git clone of phpbb3-static branch of phpbb-static
PHP JavaScript CSS
Latest commit cb47f02 Jan 30, 2017 @automatthias committed on GitHub Merge pull request #6 from chrisboylan/master
Update README to correct filename

README.md

phpbb3-static

Requirements

  1. php7.0-cli
  2. php7.0-intl
  3. php7.0-mysql (the converter only works with MySQL databases)
  4. php7.0-dba
  5. PEAR's HTML_BBCodeParser (http://pear.php.net/package/HTML\_BBCodeParser2)
  6. A running instance of your forum (read-only is fine)

Usage

  1. In your forum, go to the control panel, server load section, and set the server load limit to zero, and session limit to zero.

    Otherwise the script won't manage to fetch all posts via HTTP, because it will be blocked by the forum. If this happens, the script will stop with an error.

  2. Make sure your forum uses the prosilver skin.

  3. Copy config.php-example to config.php and edit it. Set your database configuration.

  4. Create the static/ directory

    $ mkdir static
    
  5. Run the scripts

    $ php extract.php
    

    You now have the forum-data.json file in the working directory.

    $ php legacy_write_html.php
    
  6. Copy resources (css, js, etc)

    $ cp -r templates/res/* static/
    
  7. Point your browser to static/ directory

  8. Final touches: you might need to copy your forum's smilies directory (images/smilies) into the static directory.

  9. That's all :)

Redirects from old URLs

If you would like to preserve the old URLs and redirect to the archive, you can generate a file with redirection data:

php generate_redirection_data.php

This command will generate redirection-data.php.

Then customize the included viewforum.php and viewtopic.php files, copy redirection-data.php there too, it's necessary for redirections to work.

Bugs / known issues

There are usability issues: if you go from the list of topics to a topic and then go back, you'll lose your position in the list of forums, see issue #3.