<commit_before>About
=======

TheBuzzEngine is a simple commenting system, designed for Google App
Engine, as a replacement for DISQUS and similar services.

Working Example
---------------

[http://thebuzzengine.appspot.com/#comments](http://thebuzzengine.appspot.com/#comments)

Details
=======

I tried to use [Disqus](http://disqus.com) for adding commenting to my
blog pages; but frankly Disqus kind of sucks, as it is too complex,
too hard to optimize and just provides too much. All I need is:

- 4 fields: Name, Email, URL + Comment
- Those 3 author-related fields should be tracked with a cookie and
  auto-completed; no stinkin' Facebook / Twitter login for me
- Gravatar for user images, and that's enough
- Moderation with Askimet and/or manual approvals
- Fast, light

TheBuzzEngine is an implementation for the above (having control over
the source-code is gratifying); and it runs on Google's App Engine,
which is both free of charge (for me, as I won't exceed the free
quota) and infinitely scalable (at least for this type of problem).

I just started working on it. Work in progress.

Highlights
----------

Cross-domain requests are needed and are implemented using
Access-Control-Allow-Origin, if the browser has support for it,
otherwise it uses a Flash plugin as a fallback (e.g. IExplorer < 8,
Firefox < 3.5).

The flash plugin is a lot slower / heavyweight and is not loaded
unless needed.

App Engine Facilities used thus far:

- datastore
- memcached
- tasks queue
- sending email

Missing
-------

Integration with Askimet + moderation interface are missing for
now. Myself I'm relying on the App Engine's own admin interface, but
it is suboptimal and I'm going to improve this.

Only tested in Firefox + Chrome, but should work well in IExplorer and
older browser. Still, more testing is neeed.<commit_msg>changed readme<commit_after>About
=======

TheBuzzEngine is a simple commenting system, designed for Google App
Engine, as a replacement for DISQUS and similar services.

Working Example
---------------

[http://alexn.org/TheBuzzEngine/#comments](http://alexn.org/TheBuzzEngine/#comments)

Details
=======

I tried to use [Disqus](http://disqus.com) for adding commenting to my
blog pages; but Disqus is too complex and I need something simpler:

- 4 fields: Name, Email, URL + Comment
- Those 3 author-related fields should be tracked with a cookie and
  auto-completed
- Gravatar for user images
- Moderation (editing or removing) by email
- Fast, light

TheBuzzEngine is an implementation for the above and it runs on Google's App Engine.

Highlights
----------

Cross-domain requests are needed and are implemented using
Access-Control-Allow-Origin, if the browser has support for it,
otherwise it uses a Flash plugin as a fallback (e.g. IExplorer < 8,
Firefox < 3.5).

The flash plugin is a lot slower / heavyweight and is not loaded
unless needed.

App Engine Facilities used thus far:

- datastore
- memcached
- tasks queue
- sending email

Browsers supported
------------------

Tested with Chrome 5, Firefox 3.5, Opera 11, IExplorer 8, IExplorer 6.

In IExplorer &lt; 8 the commenting form is disabled (meaning only
comments are shown). I may fix this, but incentive for me to fix it
for IExplorer 6 is pretty low. If you want IExplorer 6, send me a note
and I'll reconsider.
{'fraction_non_alphanumeric': 0.08890898131404461, 'fraction_numerical': 0.006027727546714889, 'mean_word_length': 3.734664764621969, 'pattern_counts': {'":': 0, '<': 7, '<?xml version=': 0, '>': 3, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 1, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '6375083', 'n_tokens_mistral': 977, 'n_tokens_neox': 903, 'n_words': 465}