Changes between Version 4 and Version 5 of qPloneBlog


Ignore:
Timestamp:
Dec 15, 2006 10:20:45 AM (18 years ago)
Author:
olha
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • qPloneBlog

    v4 v5  
    11== What Is qPloneBlog ? == 
    2 qPloneBlog is a a !SimpleBlog based product with refactorings and extendings, enhanced with the following products: 
     2qPloneBlog is a a !SimpleBlog based product with refactorings and extendings, enhanced with the following Package's Products: 
    33 
    4  * [http://projects.quintagroup.com/products/wiki/qPingTool '''qPingTool'''] 
     4 * SimpleBlog v.qg2.5 
     5 * qPingTool v.0.3 
     6   * qRSS2Syndication v. 0.5 
     7   * XMLRPCMethod, v.XMLRPC Method-1-1 
     8 * RPCAuth v.0.1.0-final 
     9 * qTrackSpam (extender product) v.0.2 
     10 * adsenseproduct (extender product) v.0.1 
     11 
     12 * [http://projects.quintagroup.com/products/wiki/qPingTool '''qPingTool '''] 
    513 * [http://projects.quintagroup.com/products/wiki/qRRS2Syndication '''qRSS2Syndication'''] 
    614 * [http://projects.quintagroup.com/products/wiki/qTrackSpam '''qTrackSpam'''] 
     
    1321 * ''Blog Folder'' - Folder that can only exist inside the Blog container. The folder allows you to organize the Blog Entries in any way you like. 
    1422 
    15  == Categories == 
     23 == Applied Features == 
     24 * categorization 
     25 * technorati tags support 
     26 * trackback supporting with management and spam defense 
     27 * pinging 
     28 * RSS1, RSS2 syndication 
     29 * allow working with Blogger, Weblog, MetaWeblog APIs 
     30 * bookmarklets 
     31 * Google adsense providinig 
     32 
     33 
     34 == Dependencies: == 
     35 
     36 * Plone v.2.1+ 
     37 * Archetypes v.1.3.5 and above 
     38 * ATContentTypes v.1.0.1-final and above 
     39 
     40 == Requirements == 
     41 * Plone 2.1.x 
     42 * qRSS2Syndication 
     43 * qPingTool 
     44 * XMLRPCMethod 
     45 * Archetypes 1.3.5 and above 
     46 
     47  == Categories == 
    1648!SimpleBlog can use categories to classify Blog Entries. 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 Blog Entry. Next to that, Blog Folders can define additional categories. 
    1749 
     
    2153 
    2254Blog Entries can be searched for in the Catalog and in Topics using categories. Use the Entry Category index. 
     55 
    2356 
    2457 == Portlets == 
     
    3770 
    3871 == Installation == 
     72 1. Download qPloneBlog package 
     73 2. Install !SimpleBlog, qRSS2Syndication, qPingTool, qTrackSpam as usual Plone products (put all package's products to Plone's Product directory) 
     74 3. Install in your Plone instance with Quick Installer (Plone Control Panel ->Add/remove Products) 
    3975 
    40  1. Install !SimpleBlog, qRSS2Syndication, qPingTool as usual Plone products 
    41  2. Install in your Plone instance with Quick Installer (Plone Control Panel ->Add/remove Products) 
     76 == Product Setup and Tuning == 
     77 * SimpleBlog: 
     78   * in plone control panel go to SimpleBlog setup. 
     79      Here is portal wide options for blogs. 
    4280 
    43  == Requirements == 
     81 * Pinging: 
     82   * in ZMI in portal_pingtool input web address of your site 
     83   * in ZMI in portal_syndication: 
     84      * allow syndication in portal_pingtool/propertiesForm 
     85      * allow syndication tab visibility in portal_syndication/manage_editActionsForm 
     86   * in plone control panel go to Ping Tool setup. 
     87      Here you can add, delete, change ping info for pinging sites list. 
     88   * go to Blog or BlogFolder, which you wish to ping. 
     89      * in syndication tab - allow syndication 
     90      * in added 'ping setup' tab - enable pinging and select desired ping sites and save this settings. 
     91       * here you can ping container's content to selected sites whenever you want. 
    4492 
    45  * Plone 2.1.x 
    46  * qRSS2Syndication 
    47  * qPingTool 
    48  * XMLRPCMethod 
    49  * Archetypes 1.3.5 and above 
     93 * Trackback management: 
     94    You have 2 configlets in plone control panel: 
     95   * BlackList Importer - allow you form URL's black list - both: by direct Black list editing or by file uploading. 
     96        black list records interprets as regular expressions. 
     97   * Clean TrackBacks - allow manage new (not published) trackbacks: mark as black and remove, publish. 
     98        Represent all trackbacks from all portal's blogs in table. 
     99 
     100 * Adsense in blogs - allow adding google adsense block in Blog entries. 
     101   * go to plone control panel to Adsense Properties and input your customer Id 
     102 
     103 * Blog API - for working with blog and it's content through external application. 
     104 
     105 == Description == 
     106qPloneBlog is an easy to use Plone based weblog application with fore portal types: Blog, BlogFolder, BlogEntry and  Trackback: 
     107 * Blog - Folderish object that is the container for the BlogEntries and the front-page of the weblog. 
     108 * BlogEntry - Entry object inside the weblog. 
     109 * BlogFolder - Folder that can only exist inside the Blog container. The folder allows you to organize the BlogEntries in any way you like. 
     110 * 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. 
     111 
     112 == Getting started == 
     113You 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: 
     114 
     115  * '''Short Name''', '''Title''', '''Description''' will speak for themselves. 
     116 
     117  * '''Maximum number of blog entries to display''' defines how many items should be visible on the Blog's front-page. 
     118 
     119  * '''Available entry Categories''', '''Tags''' is a list of categories and tags accordingly, that can be used inside BlogEntries one category or tag per line). 
     120 
     121After clicking on '''next''' button you will go to next blog's '''[interface]''' property list and provide appropriate customizations: 
     122 
     123  * '''Show warning for unpublished entries''' - turning on/off displaying warning on the blog's frontpage if there are entries that are not yet published. 
     124 
     125  * '''Show Byline footer''', '''Show Icons''' - checkboxes for switching on/off appearance accordingly footer and icon for BlogEntry.  
     126 
     127  * '''Enable technorati tags''' and '''Allow Trackback''' - will speak for themselves. 
     128 
     129  * '''Turn ... bookmarklet''' - turn on/off appearance appropriate bookmarklet in the Byline footer. 
     130 
     131  * '''Turn top Adsence block''' and '''Turn bottom Adsence block''' - turn on/off top and bottom google adsense blocks for blog entries. 
     132 
     133  * '''Select top adsence template''' and '''Select bottom adsence template''' - give you possibility to chose an adsense template. 
     134 
     135After 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. 
     136 
     137After you have created the Blog, you can start creating BlogEntries. Choose BlogEntry from the Add items list and fill in the form: 
     138 
     139  * '''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!! 
     140 
     141  * '''Always on top''' Controls if the Entry, when published is always shown first. This can be handy for announcements etc. 
     142 
     143  * '''Categories''' Select one or more categories from the list to classify the BlogEntry. 
     144 
     145  * '''Tags''' - allow you select or add tag(s) for technorati.com 
     146 
     147  * '''sendTrackBackURLs''' - a list of trackback URLs (one per line). On publishing this blog entry, information about it sends to URLs. 
     148 
     149  * '''Digg topic''' - Choose the digg topic for symplify blog entry readers digging this entry. 
     150 
     151  * '''Related items''' point to other content in your portal to indicate them as related. 
     152 
     153  * '''Allow Discussion on this item''' control whether people can comment on this entry. 
     154 
     155After 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 
     156The 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. 
     157 
     158Inside 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). 
     159BlogFolders are there for your convenience, to organize or archive Entries in any way you want and to have additional categories (see below). 
     160 
     161To BlogEntry also Trackback can be added. Trackback include following fields: 
     162 
     163  * '''Short Name''', '''Title''', '''Description''' will speak for themselves. 
     164 
     165  * '''Url''', '''Blog_name''' and '''excerpt''' point to URL, Blog's name and 
     166    excerpt accordingly of trackbacked blog post, frow witch this blog entry 
     167    was linked in. 
     168 
     169Commonly 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. 
     170 
     171 == Technorati Tags == 
     172qPloneBlog 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. 
     173 
     174 == Other Features == 
     175 * RSS2 SUPPORT with qRSS2Syndication product (http://projects.quintagroup.com/products/wiki/qRRS2Syndication) 
     176 
     177 * BLOGGER APIS 
     178    qPloneBlog provide 3 blogger APIs: 
     179      - MetaWeblog API 
     180      - MovableType API 
     181      - Blogger API 
     182    You need not to perform any tuning in Blog or portal - only in Blogger apllication for use this possibility. 
     183 
     184 * BOOKMARKLETS 
     185    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. 
     186 
     187 * GOOGLE ADSENSE 
     188   On Blog editing page, on interface shemata also presernt 2 checkboxes: 
     189    '''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'''. 
     190    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. 
     191    And at last - you have to go to plone control panel, to '''Adsense Properties''' and enter '''customer Id''', got from Google.