Changeset 1572 for trunk

Show
Ignore:
Timestamp:
07/16/09 20:47:24 (5 months ago)
Author:
bsmith
Message:

Reformatting README

Files:
1 moved

Legend:

Unmodified
Added
Removed
  • trunk/FacebookCommenters/README.md

    r1570 r1572  
    77## Overview 
    88 
    9 The Facebook Connect Commenters plugin for Movable Type allows commenters to login to your 
    10 blog using their Facebook account.  It makes use of the Facebook Connect APIs to provide a 
    11 rich user experience.  Commenters are able to automatically bring their name, profile photo, 
    12 and friends with them when commenting on a blog running this plugin. 
     9The Facebook Connect Commenters plugin for Movable Type allows commenters to login to your blog using their Facebook account.  It makes use of the Facebook Connect APIs to provide a rich user experience.  Commenters are able to automatically bring their name, profile photo, and friends with them when commenting on a blog running this plugin. 
    1310 
    14 All of this profile information respects a user's privacy settings from Facebook; if they only 
    15 share their profile photo with their friends then it won't be displayed publicly on a blog. 
    16 Once a Facebook user has logged in, comments left from other Facebook users will display 
    17 additional data.  Profile photos and names that were hidden publicly will now be displayed 
    18 assuming the logged in user is able to see them on Facebook.com.  Additionally, comments left 
    19 from friends of the user on Facebook will be highlighted. 
     11All of this profile information respects a user's privacy settings from Facebook; if they only share their profile photo with their friends then it won't be displayed publicly on a blog. Once a Facebook user has logged in, comments left from other Facebook users will display additional data.  Profile photos and names that were hidden publicly will now be displayed assuming the logged in user is able to see them on Facebook.com.  Additionally, comments left from friends of the user on Facebook will be highlighted. 
    2012 
    21 After leaving a comment, the Facebook user will be given the option to share with their 
    22 friends on Facebook that they commented on the blog post.  This in turn should help others 
    23 discover your blog. 
     13After leaving a comment, the Facebook user will be given the option to share with their friends on Facebook that they commented on the blog post.  This in turn should help others discover your blog. 
    2414 
    25 **PLEASE NOTE:** Facebook Connect currently requires pre-approval in order for you to launch your 
    26 blog integration. As long as you are using the standard blog plugin, this should be painless 
    27 and quick – it should take just a few days at the most.    
     15**PLEASE NOTE:** Facebook Connect currently requires pre-approval in order for you to launch your blog integration. As long as you are using the standard blog plugin, this should be painless and quick – it should take just a few days at the most.    
    2816 
    2917Check here to see if Facebook Connect is available for launch with out approval: <http://wiki.developers.facebook.com/index.php/Facebook_Connect_Launch_Plans> 
     
    3725* JSON::XS 2.0 or greater. 
    3826 
    39 The Facebook Commenters plugin ships with all of the other external libraries you should 
    40 need to run it. 
     27The Facebook Commenters plugin ships with all of the other external libraries you should need to run it. 
    4128 
    4229## Installation 
     
    6956## Template Code 
    7057 
    71 To add basic support for Facebook Connect, place the following tag in your Header template 
    72 before the closing "head" tag.  This will enable Facebook Connect on your blog, but will not 
    73 customize the display of your comments. 
     58To add basic support for Facebook Connect, place the following tag in your Header template before the closing "head" tag.  This will enable Facebook Connect on your blog, but will not customize the display of your comments. 
    7459 
    7560    <$mt:GreetFacebookCommenters$> 
    7661 
    77 To display a Facebook user's profile photo next to their comment, you will have to use a 
    78 Comment Detail template which includes userpics.  The following template should work in most 
    79 cases and 
    80 http://www.movabletype.org/documentation/designer/publishing-comments-with-userpics.html is a 
    81 useful guide to adding userpics to your templates. 
     62To display a Facebook user's profile photo next to their comment, you will have to use a Comment Detail template which includes userpics.  The following template should work in most cases and http://www.movabletype.org/documentation/designer/publishing-comments-with-userpics.html is a useful guide to adding userpics to your templates. 
    8263 
    8364    <div class="comment"<mt:IfArchiveTypeEnabled archive_type="Individual"> id="comment-<$mt:CommentID$>"</mt:IfArchiveTypeEnabled>> 
     
    119100## Styles 
    120101 
    121 While you don't need to customize any of the CSS styles, there are many CSS classes which 
    122 can be tweaked to adjust the display of comments. 
     102While you don't need to customize any of the CSS styles, there are many CSS classes which can be tweaked to adjust the display of comments. 
    123103 
    124104    .comment-friend {