phpBB

Development Wiki

GSoC/2013/Ideas

From phpBB Development Wiki

Revision as of 12:54, 11 April 2013 by Prototech (Talk | contribs)

This page is based on the ideas page of 2012 and a similar page in the KDE community wiki.

General Information

phpBB is applying to participate as a mentor organisation in Google Summer of Code 2013. If you are a student please read GSoC/2013/Instructions for application instructions. On this page you can find ideas for projects which might inspire your application. Keep in mind that you may also suggest your own project if you have a great idea for improving phpBB.

If you are a mentor, please add yourself to the list of available mentors of ideas that you think you could mentor. Feel free to add further ideas, preferably based on already discussed RFCs from Area51

Ideas

phpBB Core - User/Admin Facing

Command Line Interface

Summary: A number of maintenance tasks, such as updating a forum could be made more accessible to system administrators by making them run on a console. Some tasks, for example phpBB's cron can already be run on the console and it would be great to unify these into a single phpBB CLI utility. Further functionality could include the management of extensions or modifying phpBB configuration settings. The command line interface should be built using the Symfony Console component.

Expected results: A phpBB command line utility making a number of administrative and maintenance available without a web browser. Clear separation of functionality into reusable APIs shared by web based and command line based tools, and a command line frontend.

Knowledge Prerequisite: Object-oriented PHP required, familiarity with command line utilities useful but not mandatory.

Further Information: RFC on Area51

Available Mentors: Nils Adermann, Andreas Fischer

phpBB Core - Backend

Session Backend Abstraction

Summary: High traffic websites can already make use of fast in-memory stores (such as memcached or Redis) for improved caching. However volatile session data is still handled by the (relational) database, occasionally causing load problems. First very complete test coverage of current session code should be achieved to be able to guarantee the continued correct functionality of the session mechanism, which is of critical importance to running a board. The session code should then be refactored to provide an abstraction of the storage mechanism used, to allow for faster backends to be implemented.

Expected results: A properly designed storage interface for session data and working backend implementations for relational databases and memcached. A Redis implementation would be useful but is optional.

Knowledge Prerequisite: Object-oriented PHP required, familiarity with key-value stores useful but not mandatory.

Further Information: RFC on Area51 Tracker Ticket Pull request for some initial changes

Available Mentors: Nils Adermann, Andreas Fischer

Wolis

Summary: Wolis is an external test suite for phpBB. It serves a similar function to phpBB's functional tests but goes about achieving this task in a markedly different way. Unlike phpBB which is primarily implemented in PHP, Wolis is implemented 3/4 in Python and 1/4 in JavaScript.

There are several possible subprojects within this project:

  • Expanding Wolis' test coverage of phpBB. This means writing new tests using existing tests as a guide. This is the most straightforward of the subprojects, requiring pretty basic understanding of Python and JavaScript as well as phpBB.
  • Implementing new tests. The difference from the previous subproject is that there are no existing tests that are similar. One example of a new test would be solving captchas during registration. Another would be testing that emails are correctly generated and submitted. This subproject will require more extensive Python knowledge.
  • Porting JavaScript tests to Capybara. Rather than using CasperJS, frontend tests can be rewritten to use Capybara, ideally with PhantomJS as the backend. Part of this subproject is getting Capybara working with PhantomJS. This subproject also involves writing the test framework/runner code to invoke Capybara tests from Python test runner. Reasonable Python knowledge is required as well as significant Ruby knowledge.
  • Somewhat alternatively to the previous subproject, the entire Wolis project may be rewritten to use Capybara. There are benefits in using a single language for writing tests. This subproject will require extensive Ruby knowledge and significant Python knowledge. You will be rewriting test runner and framework as well as tests themselves.


Available Mentors: Oleg Pudeyev

Auth Plugin Refactoring

Summary: This is a subset of 2012 GSoC "Auth Plugin Refactoring & User Integration" project. There is a fair amount of code that was written in 2012 that can be built upon. It consists of a new interface as well as a proof of concept integration with Zend's OpenID libraries, but changes may be necessary.

This particular project concentrates on refactoring of existing authentication plugins/backends into an object oriented, modern PHP structure. The expected result is the same functionality that already exists in phpBB implemented in a modular and extensible manner.

Implementation or integration of additional authentication mechanisms such as OAuth can be done under the umbrella of this project with the goal of demonstrating modularity and flexibility of new auth plugin architecture.

Further Information: RFC on Area51 Tracker Ticket Pull Request from GSoC 2012

Available Mentors: Oleg Pudeyev, Nils Adermann

OAuth

Summary: This is a follow-up project to "Auth Plugin Refactoring". If it is attempted, it should likely be done by the same person.

The goal of this project is to implement OAuth to the extent where it is usable using the architecture developed in auth plugin refactoring project. This project concentrates on implementing OAuth functionality. Naturally, some changes to auth plugin achitecture and/or other auth plugins may be required, which is fine.

To avoid repeating work that was already done, existing code from 2012 attempt at OAuth should be used to the extent it is possible and practical.

Available Mentors: Oleg Pudeyev, Nils Adermann

Website

Documentation & KB System

Brief Explanation: We are currently consolidating our old Knowledge Base, Flash Tutorials Section and Documentation into a new web application, built in the style of a phpBB Modification, which can be released to the wider community. A lot of the groundwork has already been done, but its up to you to improve upon the already existing code base with new features & improvements and stabilize it ready for use in production.

Expected Results: The Documentation & KB System stable with proposed features complete. It should be able to be broken down into smaller manageable phases/chunks (one per feature or bug fix) and your timeline should detail these phases.

Knowledge Prerequisites: PHP (Essential), phpBB (Preferred), Git (Preferred), Javascript (Useful)

Available Mentors: Yuriy Rusko, Michael Cullum

Network Status Micro-Site

Brief Explanation: We have built a status site to monitor the phpbb.com network using symfony but we plan to do so much more than just offer updates and show the status of different sites. We currently use pingdom and their API to get the status of sites. Your job would be to improve the status site with new features/changes to make it both more usable and helpful. Some suggested features/changes are below but you are not just limited to these and can suggest others in your proposal:

  • Notification Emails to selected Users on Downtime
  • Logging of Downtime
  • Statistics on Uptime & More
  • More Advanced Usage of the Pingdom API (i.e. Able to add new checks from the status site, showing root cause analysis for staff)
  • Ability to force re-checking from pingdom's API


Expected Results: We expect all proposed features/improvements/changes completed. It should be able to be broken down into smaller manageable phases/chunks (one per feature or bug fix) and your timeline should detail these phases.

Existing Code: https://github.com/phpbb/phpBBStatusSite

Knowledge Prerequisites: PHP (Essential), Symfony (Preferred), Git (Preferred)

Available Mentors": Yuriy Rusko, Michael Cullum

Area51/Development Micro-Site

Brief Explanation: Area51 is a micro-site for phpBB.com for development of phpBB. It contains the Continuous Integration, Development Discussion Board, API Documentation, Development Wiki, Bug Tracker and more. We would like this revamped in either a frontend way (new design that can have a header shared by all the web applications and design for the main informational pages) or new pages/features or both. Some suggested changes are below but you are not just limited to these and can suggest others in your proposal:

  • A New Getting Involved Page
  • More Statistics using data from Bamboo (CI), JIRA (Bug Tracker), Github and the development board
  • Intergration with JIRA, Bamboo and Github
  • Moving to phpDocumenter2 for API Documentation
  • New Area51 Style
  • Creating a parser for events docblocks and a UI to present the documentation in (Could be made a plugin for phpDocumenter2 if you choose)


Expected Results: We expect all proposed features/improvements/changes completed. It should be able to be broken down into smaller manageable phases/chunks (one per feature or bug fix) and your timeline should detail these phases.

Existing Code: https://github.com/phpbb/area51

Knowledge Prerequisites: PHP (Essential), Web Design & Usability (Essential), HTML/CSS (Essential), Symfony (Preferred), Git (Preferred), Javascript (Useful).

Available Mentors: Yuriy Rusko, Michael Cullum

Extensions

In 3.1, we would like to encourage the creation of extensions, rather than MODs, for 3rd party contributions. The major difference between the two is that MODs require a core code modification of some kind, whereas extensions are designed to be self-contained plugins that modify behaviour through responding to events triggered in core code, rather than modification of the code.

The difference between the two is rather drastic so we would like to provide a few real-world examples. MOD authors can then familiarise themselves with the new extension system by looking at these. While we do not necessarily want all GSoC students to focus on creating extensions, as opposed to improving the core project itself, we would appreciate one or two extensions to act as fully-functional examples. As a student, you will not be required to support or maintain the extension beyond the timeframe of GSoC, unless you wish to do so. And we certainly hope you'll stick around!

It is a good idea to become familiar with the basic aspects of the extensions system prior to the start of GSoC. However, the extension you create is going to be one of the first extensions ever built, so the examples available to you are very limited. You are of course welcome to ask any questions you might have on IRC.

Karma

Summary: While you don't necessarily have to name it "Karma" (reputation, etc. also work), the idea behind this extension is to add a way for users to publicly give positive or negative feedback about a user based on their contributions to the community (i.e. posts and topics, but should have a way for other extensions to add items that can receive Karma). This MODmay be of use when researching features to include.

Expected results: Creation of a fully functional extension that adds a Karma system.

Knowledge prerequisites: PHP, HTML, Javascript/jQuery

Available Mentors: Joas Schilling, Marc Alexander

Points

Summary: Points/cash MODs have proven very popular for both phpBB 2.0 and 3.0. They basically allow users to give other community members virtual "cash" or "points" that can be used for various things. This extension should create a way for other extensions to interact with and use members' points. This MOD may be of use when researching features to include.

Expected results: A fully functional points/virtual cash system

Knowledge prerequisites: PHP, HTML

Available Mentors: Joas Schilling, Marc Alexander

Your Own

You do not have to use one of the ideas listed here. For non-website ideas, RFCs on Area51 are a good source of ideas as they represent what our users already told us they want. However, if you propose an original idea it will have a higher chance of being accepted if it satisfies the following two criteria:

  1. Checkpointable - it should be possible to break down your project into pieces that are by themselves meaningful. In practical terms, this means you should be sending a pull request every 1-2 weeks reflecting your work during that period, and the pull request should be individually mergeable. Avoid proposing a project that cannot be split into 1-2 week chunks.
  1. Likely to be completed - this involves several factors, but at the end of the day the goal is for your work to be finished within the GSoC timeframe. You should start by detailing components of your project to sufficient extent that they can be estimated. Then, honestly estimate how long you think it will take you. Then double that estimate. If you exceed 3 months, your proposal is probably too ambitious and you should reduce its scope.

Contacts

These are all the people affiliated with phpBB who are assisting with the program as (backup) mentors or (backup) org admins. Their IRC Nicks are listed and you can find them on freenode in #phpbb-dev. They can help you with anything related to the ideas they are mentoring or general GSoC queries.

Org Admins:

  • Main: Yuriy Rusko - IRC: Marshalrusty OR YuriyRusko // Timezone: UTC -5
  • Backup: Patrick Webster - IRC: Noxwizard // Timezone: UTC -6


Mentors:

  • Nils Adermann - IRC: naderman // Timezone: UTC +1 // Focus: Core Ideas
  • Andreas Fischer - IRC: bantu // Timezone: UTC +1 // Focus: Core Ideas
  • Oleg Pudeyev - IRC: nn- // Email: oleg@bsdpower.com // Timezone: UTC -5 // Focus: Core Ideas
  • Joas Schilling - IRC: nickvergessen // Timezone: UTC +1 // Focus: Core Ideas & Extension Ideas
  • Yuriy Rusko - IRC: Marshalrusty OR YuriyRusko // Timezone: UTC -5 // Focus: Website Ideas
  • Michael Cullum - IRC: MichaelC // Timezone: UTC // Focus: Website Ideas
  • Marc Alexander - IRC: Marc // Timezone: UTC +1 // Focus: Extension Ideas