Difference between revisions of "User:TerryE/phpBB3.0.7 Upgrade/Issues and Actions"

From Apache OpenOffice Wiki
Jump to: navigation, search
(Forum Customisation)
Line 3: Line 3:
 
|}
 
|}
 
I have included the list of open issues and activities that I intend to carried out as part of the phpBB V3.0.7 upgrade below.   
 
I have included the list of open issues and activities that I intend to carried out as part of the phpBB V3.0.7 upgrade below.   
 
+
== The Core Build ==
 
+
=== Code Base ===
== Code Base ==
+
  
 
* The core phpBB code base from [http://www.ohloh.net/p/phpbb/download?filename=phpBB-3.0.7.tar.bz2 phpBB 3.0.7 Download]  
 
* The core phpBB code base from [http://www.ohloh.net/p/phpbb/download?filename=phpBB-3.0.7.tar.bz2 phpBB 3.0.7 Download]  
Line 56: Line 55:
 
* '''acm_mysqli.php''' a module which uses MySQL to implement the phpBB [http://wiki.phpbb.com/Cache cache].
 
* '''acm_mysqli.php''' a module which uses MySQL to implement the phpBB [http://wiki.phpbb.com/Cache cache].
  
== Forum Customisation ==
+
=== Forum Customisation ===
 
The following customisations have been carried over from Version 3.0.5, and the patch file which applies these changes has been regressed from the 3.0.5 code base to the 3.0.7 code base:  
 
The following customisations have been carried over from Version 3.0.5, and the patch file which applies these changes has been regressed from the 3.0.5 code base to the 3.0.7 code base:  
  
Line 149: Line 148:
 
| XX/common.php <br>(where XX = language) || &nbsp;  || &nbsp;  || &nbsp;  || &nbsp;  || &nbsp;  || x || &nbsp;  || x || x || &nbsp;  || &nbsp;  || &nbsp;  || &nbsp;  ||  
 
| XX/common.php <br>(where XX = language) || &nbsp;  || &nbsp;  || &nbsp;  || &nbsp;  || &nbsp;  || x || &nbsp;  || x || x || &nbsp;  || &nbsp;  || &nbsp;  || &nbsp;  ||  
 
|}
 
|}
 +
 +
=== The build process ===
 +
 +
This is a modified rerun of what I did for the 3.0.4 and 3.0.5 upgrades.
  
 
== Automated Backup ==
 
== Automated Backup ==

Revision as of 18:32, 12 March 2010

I have included the list of open issues and activities that I intend to carried out as part of the phpBB V3.0.7 upgrade below.

The Core Build

Code Base

Language
Language files
Prosilver GIFs
English (U.K.) (built-in) (built-in)
English (U.S.) lang_en_us.tar.gz prosilver_en_us.tar.gz
French lang_fr.tar.gz prosilver_fr.tar.gz
Catalan lang_ca.tar.gz prosilver_ca.tar.gz
Catalan (Valencian) lang_ca_pv.tar.gz prosilver_ca_pv.tar.gz
Dutch lang_nl.tar.gz prosilver_nl.tar.gz
Hungarian lang_hu.tar.gz prosilver_hu.tar.gz
Italian lang_it.tar.gz prosilver_it.tar.gz
Japanese lang_ja.tar.gz prosilver_ja.tar.gz
Mandarin Chinese (Traditional script) lang_zh_cmn_hant.tar.gz prosilver_zh_cmn_hant.tar.gz
Mandarin Chinese (Simplified script) lang_zh_cmn_hans.tar.gz prosilver_zh_cmn_hans.tar.gz
Polish lang_pl.tar.gz prosilver_pl.tar.gz
Spanish lang_es.tar.gz prosilver_es.tar.gz
Spanish (Argentina) lang_es_ar.tar.gz prosilver_es_ar.tar.gz
Vietnamese lang_vi.tar.gz prosilver_vi.tar.gz

I've pulled these down to a kits directory from the phpBB server.

for co in ca ca_pv en_us es es_ar fr hu it ja nl pl vi zh_cmn_hant zh_cmn_hans; do
  wget http://www.phpbb.com/files/language_packs_30x/lang_$co.tar.gz
  wget http://www.phpbb.com/files/language_packs_30x/prosilver_$co.tar.gz
done

On top of this I also have two tarballs and one custom module for my OOo specific additions:

  • OOoImages.tar.bz2 which includes the extra avatar libraries, smileys etc. used on the forums.
  • OOoImages.tar.bz2 which includes the forum logos for each of the NL forums and Oracle GIFs.
  • acm_mysqli.php a module which uses MySQL to implement the phpBB cache.

Forum Customisation

The following customisations have been carried over from Version 3.0.5, and the patch file which applies these changes has been regressed from the 3.0.5 code base to the 3.0.7 code base:

  1. Reorder window title to make multi-tab title more usable. All browser tabs are labelled with their title. The phpBB3 default is to begin the title with the forum name then page category, hence if you have a lot of tabs open they are called openOffi... By putting the specific title first, it makes it a lot easier to pick the correct tab.
  2. Add Expand option to Code Block. phpBB3 now puts each code block in a scrollable window. This makes it a pain if you want to see all of the code in the browser. This mod adds an Expand option to the code block to allow you to blow it up to full size.
  3. Tweak Access key codes to remove conflicts. For those that use keyboard accelerators within the browser, the lack of a shortcut for Preview Post is a pain. This makes <Accel>+P a shortcut for Preview and <Accel>+G a shortcut for graphics.
  4. Add Active Post count to View Active Topics. This just adds a count of new posts in the Active topics heading.
  5. Add truncated title of last topic to Forum View. Lots of OOo volunteers asked for this one. It enables you to recognise at a glance if a forum has any new posts in it.
  6. Customise Headers and Footers to OpenOffice.org branding. Add OOo Community logo and adjust framing colours to match. Add OOo favicon.
  7. Add OpenOffice.org Qs to BB FAQ. The FAQ button goes to a phpBB3 standard FAQ which is all about using phpBB3. I've added a Q0 which points the user to the wiki and forum FAQs for openOffice.org info.
  8. Add instruction to “read Survival Guide before posting” to post form. The posting form now includes an instruction to read the survival guide before you post. (This is only shown if you have less than 15 posts).
  9. Optional Mandatory Subject on Registration. This is a customisation which was introduced in the French forum, and we have now rolled this out across all forums.
  10. Change move topic default. This no longer leaves a shadow topic by default.
  11. Add Poster's warning count for moderators. This was a specific request from the FR moderators. If a poster has outstanding warnings then moderators will see his/her warning count in the post heading column.
  12. Allow Cron to be run as batch script. This allows cron jobs to be scheduled using a cron script.
  13. Runtime optimisations. This is replace the file based caching with SQL caching.
  14. Miscellaneous OOo configuration. The batch equivalent of the interactive phpBB setup.
  15. Customisations that are configurable through phpBB. These don't need code or style changes:
    • Add custom fields to define users, main OS, installed OOo version and supplementary OSs.
    • Add additional BBcodes for [edit], [pre], [strike], [center], [sub], [super], [hr]

And here is the mapping of changes 1-14 onto the individual file patches within diff-307.patch. Clearly (15) doesn't involve code changes.

File  1   2   3   4   5   6   7   8   9  10  11  12  13  14 
config.php                           x
cron.php                       x  
index.php       x                  
posting.php               x          
viewforum.php x                        
viewtopic.php x                        
includes/acm/acm_memory.php                         x
includes/functions_display.php         x                
includes/functions.php           x              
includes/functions_user.php                 x        
includes/ucp/ucp_register.php                 x        
install/database_update.php                           x
Styles/prosilver Files                          
template/overall_footer.html           x              
template/bbcode.html   x                      
template/overall_header.html           x              
template/posting_buttons.html     x                    
template/ucp_register.html                 x        
template/forum_fn.js   x                      
template/viewtopic_body.html                     x    
template/index_body.html     x                    
template/mcp_move.html                   x      
template/forumlist_body.html         x                
template/posting_layout.html               x          
template/posting_editor.html     x                    
theme/colours.css           x              
theme/content.css   x                      
theme/bidi.css   x       x              
theme/common.css           x              
Language Files                          
en/help_faq.php             x            
fr/mcp.php                           x
fr/acp/common.php                           x
XX/common.php
(where XX = language)
          x   x x        

The build process

This is a modified rerun of what I did for the 3.0.4 and 3.0.5 upgrades.

Automated Backup

I had a set of scripts that ran as a cron job for the old server with the PostgresSQL D/B, but I turned these off when I moved to MySQL and we decommissioned using the OUCV server as a second site. I have a script which I use manually about once per week (on top of standard Solaris backups), but I would prefer to have a nightly incremental dump.

Automated Unactivated Users Prune

This is another batch script that I have still in development. It automates a tedious twice weekly task. Low priority until the issues which are impacting the NL Administrators are sorted.

Automated Administrator Email Responder

V1 of this was developed about a year ago. I upgraded V2 to Python for deployment with phpBB V305. This fails to part about 5% of valid email queries and rejects these as errors. I need to fix this as part of the upgrade to V307.

Logfile Retention Policy

At the moment I've configured Logfile rotation on the Apache access and error logs on a weekly basis. At the moment I periodically compress old logs and delete access logs older the 3 months. Rotation on the MySQL logs is also done on an adhoc basis. I need to implement a simple weekly cron task which:

  • Rotates the Mysql log
  • Compresses logs older than one week
  • Deletes the compress access and mysql error logs files older than 3 months.

Oracle Branding

Now that Oracle has acquired Sun, some of the Sun Footer logos have been replaced with Oracle branding ones. I will sort this out as part of this upgrade. I've done this earlier by request of Clayton.

Retiring Custom Fields

This functionality has been moved into the standard signature format. I have already done this for the EN forums and swithed off the use of custom fields in the creation of new accounts on all forums, but I've got about existing 800 accounts across three NL forums where I need to move this data into the signatures.

RSS Feed

A number of the power users on the fr forum used the previous RSS feed. This functionality has been temporarily dropped and needs reinstituted. The current implementation adopts the Simple RSS mod for phpBB3. However, this mod has significant limitations that I can't ignore. Most importantly it bypasses the phpBB access control system, allowing unregistered users to browse closed forums. I didn't get this working properly but this functionality is now superseded by a standard php V306 feature. I need to discuss this further with the fr proponents of this mod.

Standardising Forum Configurations

With 9 forums any degree of divergence can cause problems on upgrade and through-life maintenance, so we need to standardise where possible. I am not talking about language packs or basic forum structure but things like the extra BBcodes, permissible file extensions for upload, etc.. If they make sense in one OOo forum then they should be in all.

Write up phpBB 3.0.7 configuration

I have decided to do this in the phpBB wiki because this will be of more interest to phpBB admins rather than OOo Volunteers and NL Admins. I will post the link here when I've done it.

Personal tools