Documentation

phpBB Modifications Documentation

Edited by

Henry 'Kellanved' Sudhof

Paul 'Paul' Sohier

Abstract

The guide for writing good phpBB Modifications. Includes information for phpBB2.0 and phpBB3.0 modifications. Sections titled phpBB3.0 are for phpBB3.0 only, and same for phpBB2.0.


Table of Contents

1. Coding with and for phpBB3.0
1.1. Using the phpBB3.0 Language System
1.1.1. Using the language System in php
1.1.2. Using the language System in template files
1.1.3. Add new entries
1.2. Using the phpBB3.0 Template System
1.2.1. Template Files
1.2.2. Template Variables
1.2.3. Assigning Template Variables
1.2.4. Control Structures
1.2.4.1. Block Variables
1.2.4.1.1. Assigning Block Variables
1.2.4.1.2. Using Block Variables
1.2.4.2. Conditional Statements
1.2.4.2.1. Logical Operators
1.2.4.3. Including other Templates
1.2.5. Pagination
1.2.6. Templates for MODs
1.3. Using the phpBB3.0 DBAL
1.3.1. Initialising a Connection
1.3.2. Selecting Data
1.3.3. Building Queries
1.3.4. Inserting Data
1.3.5. Updating Data
1.3.6. Removing Data
1.3.7. Managing the Cache
1.4. Using phpBB3's Basic Functions
1.4.1. User input
1.4.2. Preserving sessions
1.4.3. Redirecting users
1.4.4. The User Class
1.4.5. Validating input
1.4.6. Checking authorisation
1.4.7. Inserting Posts and Private Messages
1.4.8. Building URLs, hidden fields and other HTML
1.4.9. Errors
1.4.10. Log In
1.4.11. Confirm Box
1.4.12. Page Header and Footer
1.4.13. Bringing it all together: A Sample Page
1.5. Using the phpBB3.0 Module System
1.5.1. Adding a Module
1.5.2. Writing a Module
1.5.2.1. Modules and Modes
1.5.2.2. The Info File
1.5.2.3. The Module Class
1.5.2.4. Templates
1.5.2.5. Language
2. Appendicies
2.1. The Modifications Text Template
2.1.1. Basic Template
2.1.2. Header
2.1.2.1. Title
2.1.2.2. Author
2.1.2.2.1. phpBB.com Username
2.1.2.2.2. E-mail Address
2.1.2.2.3. Real Name
2.1.2.2.4. URL
2.1.2.2.5. Examples
2.1.2.2.6. Multiple Authors
2.1.2.3. Description
2.1.2.4. Version
2.1.2.5. Installation Level
2.1.2.6. Installation Time
2.1.2.7. Files to Edit
2.1.2.8. Included Files
2.1.2.9. License
2.1.2.10. Security Disclaimer
2.1.2.11. Author Notes
2.1.2.12. MOD History
2.1.2.13. Installation Disclaimer
2.1.3. Actions
2.1.3.1. Action definition
2.1.3.2. The SQL Action
2.1.3.3. The COPY Action
2.1.3.4. The DIY INSTRUCTIONS Action
2.1.3.5. The OPEN Action
2.1.3.6. The FIND Action
2.1.3.7. The REPLACE WITH Action
2.1.3.8. The AFTER, ADD Action
2.1.3.9. The BEFORE, ADD Action
2.1.3.10. The INCREMENT Action
2.1.3.11. The IN-LINE FIND Action
2.1.3.12. The IN-LINE AFTER, ADD Action
2.1.3.13. The IN-LINE BEFORE, ADD Action
2.1.3.14. The IN-LINE REPLACE WITH Action
2.1.3.15. Conclusion
2.1.3.16. Concluding a MOD Text Template file