Alessandro Molina  committed c9cc7fb

Remove unused file and add doc

  • Participants
  • Parent commits 161ee3b
  • Branches default
  • Tags 0.0.1

Comments (0)

Files changed (2)

 About tgcomments
-tgcomments is a Pluggable application for TurboGears2.
+tgcomments is a Pluggable Comments application for TurboGears2.
+Comments can be added to any webpage by using the ``comments_for`` partial.
+TGComments supports Facebook for avatar if the user logged using tgapp-fbauth
+or if the User model provides a similar interface. Otherwise will fallback to
 You will be able to access the registration process at
-Available Hooks
-tgcomments makes available a some hooks which will be
-called during some actions to alter the default
-behavior of the appplications:
 Exposed Partials
 to render pieces of the blogging system anywhere in your
+- ``tgcomments.partials:comments_for(entity)``
+    Given any SQLAlchemy entity which is available inside your application ``model`` module
+    it will display a list of comments for that entity with a box to add a new comment.
+Provided Options
+tgcomments supports a bunch of options that can be passed to the plug call
+to change its behavior:
+- *notify_facebook* (default:True) automatically notify on facebook comments that
+    the user wrote if he has logged using Facebook
+- *allow_anonymous* (default:True) allow anonymous users to comment
 Exposed Templates
 The templates used by registration and that can be replaced with
 *tgext.pluggable.replace_template* are:
+- ``tgcomments.templates.comments_partial``

File tgcomments/templates/index.html

-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-                      "">
-<html xmlns=""
-      xmlns:py=""
-      xmlns:xi="">
-  <xi:include href="master.html" />
-  <meta content="text/html; charset=UTF-8" http-equiv="Content-Type" py:if="False"/>
-  <title>Welcome to TurboGears pluggable Application</title>
-  <link rel="stylesheet" type="text/css" media="screen" href="${tg.url('/_pluggable/tgcomments/css/style.css')}" />
-    <div py:if="request.identity">Hi ${request.identity['user']}</div>
-    <div id="hello_box">
-        <img src="${tg.url('/_pluggable/tgcomments/images/star.png')}"/>
-        Hello from, ${h.tgcomments.bold(}
-        owned by ${sample.user}
-    </div>
-    <div>${h.call_partial('tgcomments.partials:something', name='Partial')}</div>