Index: /qPloneBlog/tags/2.5.4qg/EXTERNALS_qPloneBlog.txt
===================================================================
--- /qPloneBlog/tags/2.5.4qg/EXTERNALS_qPloneBlog.txt	(revision 25)
+++ /qPloneBlog/tags/2.5.4qg/EXTERNALS_qPloneBlog.txt	(revision 25)
@@ -0,0 +1,10 @@
+#
+#
+#
+SimpleBlog http://svn.quintagroup.com/products/SimpleBlog/trunk
+qPingTool http://svn.quintagroup.com/products/qPingTool/trunk
+qTrackSpam http://svn.quintagroup.com/products/qTrackSpam/trunk
+adsenseproduct http://svn.quintagroup.com/products/adsenseproduct/trunk
+qRSS2Syndication http://svn.quintagroup.com/products/qRSS2Syndication/trunk
+XMLRPCMethod http://svn.quintagroup.com/products/XMLRPCMethod/current
+RPCAuth http://svn.quintagroup.com/products/RPCAuth/current
Index: /qPloneBlog/tags/2.5.4qg/README_qPloneBlog.txt
===================================================================
--- /qPloneBlog/tags/2.5.4qg/README_qPloneBlog.txt	(revision 25)
+++ /qPloneBlog/tags/2.5.4qg/README_qPloneBlog.txt	(revision 25)
@@ -0,0 +1,316 @@
+qPloneBlog
+
+qPloneBlog is a SimpleBlog based product with refactorings and extendings.
+
+
+APPLIED FEATURES:
+
+  - categorization
+  - technorati tags support
+  - trackback supporting with management and spam defense
+  - pinging
+  - RSS1, RSS2 syndication
+  - allow working with Blogger, Weblog, MetaWeblog APIs
+  - bookmarklets
+  - Google adsence management in blog pages
+
+
+PACKAGE's PRODUCTS:
+
+  * SimpleBlog v.qg2.5
+  * qPingTool v.0.3
+    * qRSS2Syndication v. 0.5
+    * XMLRPCMethod, v.XMLRPC Method-1-1
+  * RPCAuth v.0.1.0-final
+  * qTrackSpam (extender product) v.0.2
+  * adsenseproduct (extender product) v.0.1
+
+
+DEPENDENCIES:
+
+  * Plone v.2.1+
+  * Archetypes v.1.3.5 and above
+  * ATContentTypes v.1.0.1-final and above
+
+
+INSTALLATION
+
+  * downloads qPloneBlog package
+  * put all package's products to Plone's Product directory
+  * in ZMI create RPCAuth object in the rooty of your Plone instance.
+  * using quickinstaller install SimpleBlog, qPingTool, qRSS2Syndication,
+    qTrackSpam and adsenseproduct
+
+
+PRODUCT SETUP AND TUNING
+
+  * SimpleBlog:
+    * in plone control panel go to SimpleBlog setup.
+      Here is portal wide options for blogs.
+
+  * Pinging:
+    * in ZMI in portal_pingtool input web address of your site
+    * in ZMI in portal_syndication:
+        * allow syndication in portal_pingtool/propertiesForm
+        * allow syndication tab visibility in 
+          portal_syndication/manage_editActionsForm
+    * in plone control panel go to Ping Tool setup.
+      Here you can add, delete, change ping info for pinging sites list.
+    * go to Blog or BlogFolder, which you wish to ping.
+      * in syndication tab - allow syndication
+      * in added 'ping setup' tab - enable pinging and select desired ping
+        sites and save this settings.
+        * here you can ping container's content to selected sites
+          whenever you want.
+
+  * Trackback management:
+    You have 2 configlets in plone control panel:
+      * BlackList Importer
+        Allow you form URL's black list - both: by direct Black list
+        editing or by file uploading.
+        black list records interprets as regular expressions.
+      * Clean TrackBacks
+        Allow manage new (not published) trackbacks: mark as black and 
+        remove, publish.
+        Represent all trackbacks from all portal's blogs in table.
+
+  * Adsense in blogs
+    Allow adding google adsense block in Blog entries.
+      * go to plone control panel to Adsense Properties and input
+        you customer Id
+
+  * Blog API
+    For working with blog and it's content through external application,
+
+
+DESCRIPTION:
+
+  qPloneBlog is an easy to use Plone based weblog application with fore 
+portal types: Blog, BlogFolder, BlogEntry and  Trackback:
+  Blog - Folderish object that is the container for the BlogEntries and the
+         front-page of the weblog.
+  BlogEntry - Entry object inside the weblog.
+  BlogFolder - Folder that can only exist inside the Blog container.
+               The folder allows you to organize the BlogEntries in any way
+               you like.
+  Trackback - trackback to other blog-post (web resource possible).
+              Can be added only to BlogEntry type object.
+              Contains short information about blog-post, which links to blog
+              entry, where trackback URL, of this BlogEntry is added.
+              Can be in two workflow states: pending and published.
+
+
+GETTING STARTED
+
+  You can go to any folder that you have permissions for and add
+a Blog from any of the dropdown lists. You will be given a form
+where you can provide the necessary information to create a new Blog:
+
+  * **Short Name**, **Title**, **Description** will speak for themselves.
+
+  * **Maximum number of blog entries to display** defines how many
+    items should be visible on the Blog's front-page.
+
+  * **Available entry Categories**, **Tags** is a list of categories
+    and tags accordingly, that can be used inside BlogEntries
+    (one category or tag per line).
+
+After clicking on **next** button you will go to next blog's
+**[interface]** property list and provide appropriate customizations:
+
+  * **Show warning for unpublished entries** - turning on/off displaying 
+    warning on the blog's frontpage if there are entries that are not 
+    yet published.
+
+  * **Show Byline footer**, **Show Icons** - checkboxes for switching on/off
+    appearance accordingly footer and icon for BlogEntry. 
+
+  * **Enable technorati tags** and **Allow Trackback** - will speak
+    for themselves.
+
+  * **Turn ... bookmarklet** - turn on/off appearance appropriate
+    bookmarklet in the Byline footer.
+
+  * **Turn top Adsence block** and **Turn bottom Adsence block** -
+    turn on/off top and bottom google adsense blocks for blog entries.
+
+  * **Select top adsence template** and **Select bottom adsence template** -
+    give you possibility to chose an adsense template.
+
+After you have created the Blog, you can adjust its Display settings from the
+Display menu in Plone. Currently there are 3 different display settings.
+Besides these settings, there is also a stylesheet in product's skin that you
+can customize at will.
+
+After you have created the Blog, you can start creating BlogEntries.
+Choose BlogEntry from the Add items list and fill in the form:
+
+  * **Short Name**, **Title**, **Teaser**, **Body** will speak for
+      themselves. **Note** when you use the Upload a file field, be aware
+      that it will replace the current content!!
+
+  * **Always on top** Controls if the Entry, when published is always shown
+    first. This can be handy for announcements etc.
+
+  * **Categories** Select one or more categories from the list to classify
+    the BlogEntry.
+
+  * **Tags** - allow you select or add tag(s) for technorati.com
+
+  * **sendTrackBackURLs** - a list of trackback URLs (one per line). On
+    publishing this blog entry, information about it sends to URLs.
+
+  * **Digg topic** - Choose the digg topic for symplify blog entry readers
+    digging this entry.
+
+  * **Related items** point to other content in your portal to indicate them
+    as related.
+
+  * **Allow Discussion on this item** control whether people can comment on
+    this entry.
+
+After the BlogEntry is saved, it will be in the 'draft' workflow state and is
+only visible by the owner and the manager (by default). So, in order to make
+it appear on the Blog's front-page, it must be set in the 'published' state
+The Blog will search and display the BlogEntries that have this state (this
+state is defined in the simpleblog_tool in ZMI and in the configlet in Plone
+setup). When putting the BlogEntry in the published state, you can also choose
+to give it an effective date somewhere in the future. SimpleBlog uses the
+standard way of publishing content.
+
+Inside the Blog you can create BlogFolders. These are a bit similar to the
+Blog itself in that it has roughly the same view but this time it only shows
+the Entries that are stored inside the BlogFolder (and subfolders).
+BlogFolders are there for your convenience, to organize or archive Entries in
+any way you want and to have additional categories (see below).
+
+To BlogEntry also Trackback can be added. Trackback include following fields:
+
+  * **Short Name**, **Title**, **Description** will speak for themselves.
+
+  * **Url**, **Blog_name** and **excerpt** point to URL, Blog's name and
+    excerpt accordingly of trackbacked blog post, frow witch this blog entry
+    was linked in.
+
+Commonly trackbacks added by blog itself (trackback system). After adding
+Trackback presents in **pending** state and on defoult permissions set is
+visible only for Manager and Owner roles. After publishing - it's visible
+for all.
+
+
+CATEGORIES
+
+  qPloneBlog can use categories to classify BlogEntries. When you edit and
+configure the Blog object, you can provide it with a list of categories that
+will present itself as a multi-selection list when you edit/create a BlogEntry.
+Next to that, BlogFolders can define additional categories.
+In BlogEntries created inside the BlogFolder, a selection can be made out of
+the categories defined in the Blog *and*, additionally, out of the ones
+defined by the BlogFolder(s) it sits in. All the categories will add up. This
+feature can be useful when the Blog is maintained by several authors. You can
+then incorporate some policy that certain Entries must be created in specific
+BlogFolders because of the additional categories. Categories you can later
+search for but you don't want exposed to all the other authors.
+
+  Next to categories defined by the Blog object and the BlogFolders, you can
+also define a set of global categories. These categories are available to all
+the BlogEntries created in the portal. Defining these global categories can
+be done in ZMI in the simpleblog_tool or in the Plone setup.
+
+  BlogEntries can be searched for in the Catalog and in Topics using 
+categories. Use the EntryCategory index.
+
+
+TECHNORATI TAGS
+
+  qPloneBlog support Technorati tags if following manner: in **Tags** field
+of BlogEntry - you may point existent or add new tag(s). On the BlogEntry
+view page - you may view pointed tags. Clicking one of the BlogEntry =tag=
+bring you to page "Everything tagged =tag=", on www.technorati.com.
+
+
+TRACKBACKS
+
+  qPLoneBlog support trackback system.
+  BlogEntry can be both trackback source (BE-source) and trackback holder
+(BE-holder).
+  BE-source provide **trackback URL** and register short information about
+every BE-holder in Trackback-type objects, by adding Trackbacks to
+BE-source.
+  BE-holder add **trackback URL** of BE-sources (to field 
+**sendTrackBackURLs**). On publishing BE-holder short information about it
+sends to list of **trackback URL**s.
+
+**trackback URL** - present on BlogEntry view page.
+**Trackback** object automatically creates and added in BE-source on
+publishing BE-holder.
+New created Trackback object appear in pending workflow state. Manager or
+Owner can publish or delete Trackback object.
+Trackbacks is visible only in navigation tree.
+
+It is qTrackSpam product, which provide trackback management
+(http://projects.quintagroup.com/products/wiki/qTrackSpam)
+For manage trackbacks it is 2 configlets in plone control panel:
+**BlackList importer** and **Clean TrackBacks**.
+  * **BlackList importer** - allow manage with blac list filters. Every line
+      in BlackList presents separate filter. Actually filter is regular
+      expression, which apply to **Url** field of new added trackback.
+  * **Clean TrackBacks** - is form to site wide trackbacks managements, which
+      allow you to select group of trackback(s) and publish or blacklist and
+      remove selection.
+
+
+PINGING
+
+(http://projects.quintagroup.com/products/wiki/qPingTool)
+  qPloneBlog allows ping Blog or BlogFolder to one or more ping servers.
+For pinging working - syndication should be allowed for portal in
+portal_syndiction/propertiesForm, and also should be allowed syndication for
+pingin container (Blog/BlogFolder), which can be done by go to syndication tab
+on pingin container (Blog/BlogFolder) or if it invisible - go to
+[pinging container URL]/synPropertiesForm URL. After that on pingin container
+adds **ping setup** tab, wich allow you to tune pinging and perform pinging of
+course. After perform pingign, information about pinging results appear in
+"portal message" block.
+  For add, delete pinging site(s) or change its properties - you should go to
+plone control panel to **Ping setup** and operate with Ping Info objects. This
+type object has following properties:
+    * Title ping site's name
+    * URL - ping site's URL
+    * Method_name - name of RPC method (get from ping site instructions)
+    * RSS_version - set version of RSS, which used to form result page for
+      ping site. Default - "Blog", leave default value if you don't now
+      exactly what you are doing.
+
+
+
+OTHER FEATURES
+
+  * RSS2 SUPPORT with qRSS2Syndication product
+    (http://projects.quintagroup.com/products/wiki/qRRS2Syndication)
+
+  * BLOGGER APIS
+    qPloneBlog provide 3 blogger APIs:
+      - MetaWeblog API
+      - MovableType API
+      - Blogger API
+    You need not to perform any tuning in Blog or portal - only in Blogger
+    apllication for use this possibility.
+
+  * BOOKMARKLETS
+    As was mentioned earlier, on Blog editing page, on interface shemata
+    settings you will see 5 checkboxes **Turn ... bookmarklet**, which manage
+    bookmarklets appearance on BlogEntry footer.
+
+  * GOOGLE ADSENSE
+      On Blog editing page, on interface shemata also presernt 2 checkboxes:
+    **Turn ... Adsence block** with self explanatory labels. It is important
+    to notise, that this checkboxes switches google adsense appearance in
+    **every BlogEntry of the blog**.
+      Other tuning google adsense block possibility is selection block type
+    for each top and bottom blocks. This featchure also present on interface
+    schemata
+    of Blog edit page.
+      And at last - you have to go to plone control panel, to
+    **Adsense Properties** and enter **customer Id**, got from Google.
+
Index: /qPloneBlog/tags/2.5.4qg/version_qPloneBlog.txt
===================================================================
--- /qPloneBlog/tags/2.5.4qg/version_qPloneBlog.txt	(revision 25)
+++ /qPloneBlog/tags/2.5.4qg/version_qPloneBlog.txt	(revision 25)
@@ -0,0 +1,1 @@
+2.5.2
