Smartfeed

Donate

 

If you want to encourage me to maintain Smartfeed, please consider sending me a small donation.

Brief Description of Smartfeed

The mod does not work with versions 3.1 or greater of phpBB. The extension does not work with versions 2.0 or 3.0.

Provides RSS 1.0, RSS 2.0, Atom 1.0 customized newsfeeds for phpBB forums. Users select forums they want, including protected forums if they can access them. Administrators can incorporate external news sources (if available as a feed) into their feeds.

Note: As of phpBB 3.0.6, phpBB has a basic Atom 1.0 newsfeed feature. If your needs are simple, this may be all that you need. You might want to read phpBB’s Atom FAQ. If you need authenticated access, have complex needs for the content of your feeds, or need RSS 1.0 or RSS 2.0 feeds for your board, Smartfeed is the mod or extension of choice. It will not conflict with the new Atom Feed feature in phpBB.

Detailed Description of Smartfeed

phpBB forums may contain restricted forums that should not normally be exposed as a feed. Smartfeed is a phpBB extension and modification that allows users to get a newsfeed for selected forums, including restricted forums if they have the privilege. This is done by using an interface program that appears on the navigation bar after installation. Smartfeed is smart enough to keep users out of forums for which they do not have access, even if they hack parameters on the URL field. Authentication is handled via a URL key/value parameter that encrypts the user’s password hash in the database. Those who are not registered can access in the newsfeed only those forums that can be read by the public.

The URL generated is then copied and pasted by the user into a newsreader. RSS 1.0, RSS 2.0 and ATOM 1.0 newsfeeds are supported. ATOM 1.0 is the default for the extension. RSS 2.0 is the default for the modification.

External feeds are integrated using the PHP SimplePie library, which is integrated into both the modification and extension.

This has been tested, but not extensively, by validating reasonably complex feeds for RSS 1.0, RSS 2.0 and ATOM 1.0 at http://validator.w3.org/feed/.

It has been tested on a MySQL 5.0 environment only but should be DBAL compliant.

Professional installation available

Installation is generally simple. As an extension, Smartfeed is installed using phpBB’s extension installation process. If downloaded as a modification, complete instructions for installing phpBB Smartfeed are included in the archive by opening the install.xml file in the browser. If you prefer to have me install it for you professionally, see my services page.


Smartfeed extension for phpBB 3.1 and higher

GitHub

Support

Release notes and discussion are on the Smartfeed extension’s discussion area.

Versions

  • 3.0.8Approved version available on phpbb.com. Supports phpBB 3.2 only (June 22, 2017) – uses a better encryption algorithm. New URLs are needed to retrieve a feed.
  • 3.0.7 – Supports phpBB 3.1 and 3.2 (May 20, 2017) – openssl is now used instead of mcrypt. New URLs may be needed to retrieve a feed.
  • 3.0.6 – Supports phpBB 3.2 Rhea (January 9, 2017)
  • 3.0.5 – Integrates external feeds (August 23, 2016)
  • 3.0.4 First approved version (April 3, 2016)
  • 3.0.3 RC2 (January 27, 2016)
  • 3.0.2 RC1 (December 5, 2015)
  • 3.0.1 Beta (November 19, 2015)
  • 3.0.0 Development (October 3, 2015)

Language translations

  • Russian (supports version 3.0.4) – provided by hd321kbps
  • German (supports version 3.0.8) – provided by Michael Kossyk

If you have a translation, please let me know. Make sure to place it on GitHub!

Features in the modification not in the extension

  • You cannot hide Smartfeed sessions. In most cases Smartfeed sessions will show up as guest sessions.
  • You cannot specify a proxy IP. If you want to use the IP authentication feature, it will apply only to your IP at the time you generated the URI. If your IP changes you will have to regenerate the URI using the Smartfeed user interface.
  • You cannot generate a new Smartfeed key.
  • You lose the ability to see protected forums if openssl is not compiled into PHP. Fortunately, it usually is compiled into PHP so it’s probably not a concern. As a result the PHP Secure Communications library is not part of the extension.
  • The feedcreator class is no longer used. Instead, phpBB’s template engine is used to generate feeds.

Features changed from the modification

  • The URL for the feed has changed due to the extensions architecture. Previously it was http://www.yoursite.com/yourforum/smartfeed.php. Now it is http://www.yoursite.com/yourforum/app.php/smartfeed/feed. Similarly the URL generator program was http://www.yoursite.com/yourforum/smartfeed_url.php and is now http://www.yoursite.com/yourforum/app.php/smartfeed/ui. Consequently, users will have to generate a new URI to use the Smartfeed extension.
  • Not only is the URI changed, the URI argument names have changed to try to make the URI more concise:
// These constants are used to identify URI key/value pair associations. Note these have changed since the phpBB 3.0 mod so URIs will be shorter.
define('SMARTFEED_BOOKMARKS', 'b'); // was bookmarks
define('SMARTFEED_ENCRYPTION_KEY', 'e'); // unchanged
define('SMARTFEED_FEED_STYLE', 'd'); // was feed_style
define('SMARTFEED_FEED_TYPE', 'y'); // was feed_type
define('SMARTFEED_FILTER_FOES', 'ff'); // was filter_foes
define('SMARTFEED_FIRST_POST', 'fp'); // was firstpostonly
define('SMARTFEED_FORUMS', 'f'); // was forum
define('SMARTFEED_LAST_VISIT', 'l'); // was lastvisit
define('SMARTFEED_MARK_PRIVATE_MESSAGES', 'k'); // was pms
define('SMARTFEED_MAX_ITEMS', 'x'); // was count_limit
define('SMARTFEED_MAX_WORDS', 'w'); // was max_word_size
define('SMARTFEED_MIN_WORDS', 'i'); // was min_word_size
define('SMARTFEED_PRIVATE_MESSAGE', 'm'); // was pms
define('SMARTFEED_REMOVE_MINE', 'r'); // was removemine
define('SMARTFEED_SORT_BY', 's'); // was sort_by
define('SMARTFEED_TIME_LIMIT', 't'); // was limit
define('SMARTFEED_USER_ID', 'u'); // unchanged

Screenshots

Click on the images to tour the User Control Panel and Administration Control Panel for the Smartfeed extension.

Administration Control Panel (Version 3.0.8)

Primary performance throttles Security settingsAdditional settings and options

User interface (Version 3.0.8)

Smartfeed user interface

In a newsreader (Firefox newsreader shown)

Smartfeed rendered feed


Smartfeed modification for phpBB 3.0

As of August 2009, a phpBB approved mod is available.

Support

I don’t actively support the modification anymore since phpBB has evolved to use extensions instead. I sporadically read the old support topic. You may wish to leave questions there. No new versions of the modification for phpBB 3.0 will be produced.

Versions

Screenshots

Administration Control Panel (Version 2.2.27)

smartfeed_acp1smartfeed_acp2smartfeed_acp3

User Control Panel (Version 2.2.27, prosilver and subsilver2 styles)

smartfeed_urlsmartfeed_url_subsilver2


Smartfeed modification for phpBB 2.0

Support

No further work will be done on these versions. If you want paid support, send me an inquiry.

Versions

  • 1.22 (02/02/2008)
  • 1.21 (11/12/2007)
  • 1.2 (11/02/2007)
  • 1.12 (09/03/2007)
  • 1.11 (02/25/2007)
  • 1.1 (01/15/2007)
  • 1.0.5 (05/13/2006) – archive missing
  • 1.0.4 (03/12/2006)
  • 1.0.3 (03/05/2006)
  • 1.0.2 (03/01/2006)
  • 1.0.1 (02/26/2006)
  • 1.0.0 (02/25/2006)
  • 0.4 (02/20/2006)
  • 0.3 (07/07/2005)
  • 0.2 (01/21/2006)
  • 0.1 (01/06/2006)
  • 0.0.2 (01/02/2006)
  • 0.0.1 (01/01/2006)
  • 0.0.0 (12/29/2005)

Page last updated November 21, 2017

2 thoughts on “Smartfeed

  1. You have to edit your .htaccess file to allow app.php/feed and bypass a .htpasswd file. In addition there is an ACP setting for Smartfeed where you have to enable its use for HTTP authentication.

  2. Any chance to make it work with http-auth? I would like to use is in thunderbird, but all my forums are private and will only display anything after successful http-auth.

Leave a Reply

Your email address will not be published. Required fields are marked *