Heim > Artikel > CMS-Tutorial > 6 einfache Schritte zur Nutzung des @Anywhere-Dienstes von Twitter
Letzte Woche hat Twitter @Anywhere gestartet, das alle Funktionen der Twitter-Plattform auf Ihre Website bringt, indem Sie nur ein paar Codezeilen hinzufügen. Mit @Anywhere ist alles möglich, von der Umwandlung eines einfachen @Benutzernamens in einen anklickbaren Link bis hin zum Erstellen neuer Tweets direkt von Ihrer persönlichen Website aus. Wie genau, zeige ich dir in diesem Tutorial!
Um @Anywhere verwenden zu können, benötigen Sie einen API-Schlüssel. Was? Nicht wahr? Kein Problem. Klicken Sie einfach hier, um eine neue Bewerbung zu registrieren (registrieren Sie sich nicht von hier aus).
Stellen Sie abschließend den Standardzugriffstyp auf „Lesen und Schreiben“ ein. Das ist sehr wichtig!
Nun werden Sie zur Seite mit den Anwendungseinstellungen weitergeleitet. Kopieren Sie den Verbraucherschlüssel (API-Schlüssel) und beginnen Sie mit der Verwendung von @Anywhere.
Öffnen Sie eine neue HTML-Datei und fügen Sie Folgendes in die -Tags ein:
<script src="http://platform.twitter.com/anywhere.js?id=<strong>APIKey</strong>&v=1" type="text/javascript"></script>
Ihr Code sollte so aussehen:
<!DOCTYPE HTML> <html> <head> <title>@Anywhere</title> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> <link href="styles.css" rel="stylesheet" type="text/css" /> <script src="http://platform.twitter.com/anywhere.js?id=APIKey&v=1" type="text/javascript"></script> </head> <body> ... </body> </html>
wird APIKey
替换为您在上一步中获得的应用程序的 API 密钥。参数 v=1
die Version sein. Möglicherweise wird Twitter in Zukunft neue Funktionen und möglicherweise eine neue Syntax hinzufügen. Um zu verhindern, dass vorhandener @Anywhere-Code beschädigt wird, behalten sie den alten Code bei (falls angegeben). Version 1 unterstützt alle gängigen Browser, einschließlich IE6.
Nachdem wir diese JavaScript-Datei eingebunden haben, können wir auf die twttr
对象,当 @Anywhere 准备就绪时,该对象将使用参数调用 anywhere()
-Funktion zugreifen:
twttr.anywhere(function(twitter) { // Actions when @Anywhere is ready });
Parameter (in diesem Fall twitter
)是我们将使用的对象,类似于 jQuery 的 $
.
Als nächstes müssen wir eine HTML-Bibliothek erstellen. Kopieren Sie den folgenden Code, fügen Sie ihn ein und fügen Sie ihn in das „body“-Tag ein.
<div id="main"> <div class="post"> <h2>My blog post</h2> <div class="content"> <p>This is a test blog post testing @Anywhere by @twitter.</p> <p>If you enjoyed this tutorial, please <a href="http://twitter.com/faelazo" class="hovercard">follow me</a> and keep in touch with @NETTUTS for more awesomeness.</p> </div> </div> <div class="comments"> <h3>Comments</h3> <ol> <li><span class="author">@corcholat</span> says: <p>Such a great tutorial! </p> </li> <li><span class="author">@faelazo</span> says: <p>You should also follow @smashingmag</p> </li> </ol> </div> </div>
Lassen Sie uns nun tiefer eintauchen.
Mit @Anywhere können wir @Erwähnungen in Links umwandeln. Diese Funktion heißt linkifyUsers
und ist sehr einfach: Sie legt das HTML-Element fest, das Sie in einen Link umwandeln möchten.
Da wir alle @Erwähnungen im Dokument in Links umwandeln möchten, rufen wir einfach die linkifyUsers()
-Funktion im Body-Element auf:
twttr.anywhere(function(twitter) { twitter("body").linkifyUsers(); });
Wie bereits erwähnt, ähnelt der „twitter“-Parameter innerhalb der Callback-Funktion dem „$“-Alias von jQuery; wenn wir @mentions in Links umwandeln möchten, können wir jedoch nur innerhalb eines bestimmten Abschnitts einen CSS-Selektor verwenden, wie unten gezeigt.
twttr.anywhere(function(twitter) { twitter(".post").linkifyUsers(); });
linkifyUsers()
接受一个对象作为参数,有两个属性:className
和 success
。通过 className
Akzeptiert ein Objekt als Parameter und verfügt über zwei Attribute: className
und success
. Mit className
können Sie die Klasse angeben, die angewendet werden soll, wenn @mentions gefunden werden, sodass Sie beispielsweise eine semantisch unsemantische „rote“ Klasse hinzufügen und diese in CSS angeben können:
.red { color:#f00; }
Hier ist der Code.
twttr.anywhere(function(twitter) { twitter("body").linkifyUsers({ className:'red' }); });
mousecards() wandelt @Erwähnungen in Links um, lädt aber beim Mouseover auch einen kleinen Popup-Tooltip. Hier ist ein einfaches Beispiel für seine Verwendung.
twttr.anywhere(function(twitter) { twitter.hovercards(); });
Aber hovercards()
足够灵活,可以包含某些元素,即使它们中没有@mention。在 HTML 中,我将“follow me”链接到 http://twitter.com/faelazo
;aber @anywhere ist schlau genug, diesen Link in eine Hover-Karte umzuwandeln. Durch das Hinzufügen der Klasse „hovercard“ zum Ankertag kümmert sich Twitter um den Rest!
twttr.anywhere(function(twitter) { // Find the @mentions and linkify as usual twitter("body").hovercards(); // Let's find the elements which has a hovercard class twitter(".hovercard").hovercards({ username: function(node){ var twitter_regexp = /twitter\.com\/([a-z0-9_]*)\/?(.*)?/gi; if(node.href.match(twitter_regexp) && (twitter_match = twitter_regexp.exec(node.href))){ return twitter_match[1]; } return ''; } }); });
username
参数采用一个函数,该函数的参数将是找到的对象(在本例中为 node
). Folgendes passiert Zeile für Zeile innerhalb der Funktion.
var twitter_regexp = /twitter\.com\/([a-z0-9_]*)/gi;
Dies ist ein regulärer Ausdruck. Es werden twitter.com/
Zeichenfolgen mit alphanumerischen Werten und Unterstrichen abgeglichen.
if(node.href.match(twitter_regexp) && (twitter_match = twitter_regexp.exec(node.href))){
Wenn der reguläre Ausdruck mit dem href-Attribut im Knotenelement übereinstimmt, wird die Variable twitter_match gesetzt, um den Wert im Array zu erfassen.
return twitter_match[1];
Die gefundenen Übereinstimmungen werden zurückgegeben.
我们添加一个“return”,以防元素确实有一个类,但不引用 twitter.com
;所以不会有匹配。如果它返回 false
或 NULL
,则脚本会引发错误。使用空字符串时,它会显示一个悬停卡,但未找到用户。
现在,如果这有点太复杂,您可以随时简化过程,并将用户名添加为锚标记的标题属性。
<a href="http://twitter.com/faelazo" class="hovercard" title="faelazo">follow me</a>
只需返回 node
的 title
属性即可。容易多了,对吧?
twitter(".hovercard").hovercards({ username: function(node){ return node.title; } });
“hovercards”可以应用于任何元素(甚至是 div),只要它指定用户名即可。
twitter("#main").hovercards({ username: function(){ return 'therrorcom'; }});
followButton()
将在先前指定的元素中的用户名参数后面附加一个按钮。
以下代码将在 #main
div 中附加一个按钮以关注 Nettuts+。
twttr.anywhere(function(twitter) { twitter("#main").followButton("nettuts"); });
followButton()
需要一个参数:要跟随的用户名。够简单吧?
tweetBox()
将附加一个框,用户可以在其中输入评论并通过您的网站发布推文。
tweetBox
可以接收一个对象作为参数,具有以下属性:
counter
(布尔值,默认true)是否显示剩余字符的计数器。
height
(整数,默认65)框的高度,以像素为单位。
width
(整数,默认515)框的宽度,以像素为单位。
label
(字符串,默认“发生了什么?”)框上方的文本。
defaultContent
(字符串,默认无)您可以默认输入 URL、@mention、#hashtag 等。
onTweet
(函数)按下推文按钮后调用。它接收两个参数:纯文本推文和 HTML 推文。
可以在带有注释类的元素之后调用默认的 tweetBox
,并使用以下代码片段。
twttr.anywhere(function(twitter) { twitter(".comments").tweetBox(); });
因此,如果您想要自定义标签、内容以及发送推文时的回调,请使用此代码。
twitter(".comments").tweetBox({ label: 'What do you think about this article?', defaultContent: '#nettuts ', onTweet: function(plain, html){ // Actions when tweet is sent } });
如果您计划用您正在使用的 CMS 替换默认评论区域,则 onTweet
可能会很有用。您仍然需要一个数据库和一个表格来显示评论,对吧?因此,您可以对 CMS 进行一些修改,并使用 onTweet
事件发出 AJAX 请求,以将推文插入数据库。
正如您可能看到的,最后两种方法需要确认才能向应用程序授予权限。 @Anywhere 有一个方法来检查用户是否使用应用程序登录(而不是在 Twitter 上)。您可以使用条件来决定是否显示某些元素。
此代码片段将在元素中附加带有注释类的连接按钮。
twttr.anywhere(function(twitter) { twitter(".comments").connectButton(); });
如果您需要不同大小的按钮,则可以传递具有属性大小和值小、中、大或 xlarge 的对象文字。请注意,“中”是默认值。
twttr.anywhere(function(twitter) { twitter(".comments").connectButton({ size: 'large' }); });
Twitter 对象包含一些额外的好处;一个是currentUser
,它是一个对象;另一个是 isConnected()
,这是一个返回布尔值的函数。从这里,我们可以创建一些条件语句。
twttr.anywhere(function(twitter) { if(twitter.isConnected()){ alert('Welcome, you are connected'); } else { twitter(".comments").connectButton(); } });
如果 isConnected()
返回 true
,我们可以显示一些用户信息,例如用户名 (screen_name)、个人资料图片 (profile_image_url)、关注者或关注者。以下是应用程序可以访问的信息的列表。让我们看看最后综述中的 currentUser
对象。
我将使用 comments 类修改 div。
<div class="comments"> <h3>Comments</h3> <ol> <li><span class="author">@corcholat</span> says: <p>Such a great tutorial! </p> </li> <li><span class="author">@faelazo</span> says: <p>You should also follow @smashingmag</p> </li> </ol> <div class="add"> <h3>Add comment</h3> <div class="author"></div> <div class="box"></div> </div> </div>
现在让我们加入 jQuery 以使事情变得更容易一些。在 和
之间插入以下代码:
<script src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.min.js" type="text/javascript"></script>
现在我们有一个可以添加评论的空间。首先,如果用户未登录我们的应用程序,我们将使用 isConnected()
条件来显示一个按钮;该按钮将被附加到带有 "add"
类的元素。
if(twitter.isConnected()){ twitter(".comments").connectButton(); }
现在让我们使用 Twitter 的 currentUser 对象。该对象可以使用 data() 方法检索信息。因此以下代码片段将检索用户的 screen_name。
twitter.currentUser.data('screen_name');
@Anywhere 让我们为 connectButton
功能指定回调函数。作为参数,它接受具有两个属性的对象: authComplete
和 signOut
;两者都是函数,因此当调用 signOut
时,我们可以刷新页面。 authComplete 也是如此。让我们用以下代码片段替换 connectButton()
行:
twitter(".comments > .add").connectButton({ authComplete: function(user) { location.reload(); }, signOut: function() { location.reload(); } });
这非常简单:我们传递一个对象作为参数,然后设置 signOut
和 authComplete
函数来重新加载页面。请注意,为了设置 signOut
事件,我删除了 isConnected()
条件的 else
子句。
接下来,让我们在条件中添加一个 tweetBox
。
if(twitter.isConnected()){ $(".comments > .add > .author").html('<img src="'+ twitter.currentUser.data('profile_image_url') +'" /> <a href="http://twitter.com/'+ twitter.currentUser.data('screen_name') +'">'+ twitter.currentUser.data('screen_name') +'</a> | <a href="javascript:twttr.anywhere.signOut();">Sign out</a>'); twitter(".comments > .add").tweetBox({ label: 'What do you think about this article?', defaultContent: '#nettuts ' }); }
如果用户已登录,则应该有一个关注按钮。同样,在条件语句中:
twitter(".comments > .add").followButton("nettuts");
这是完整的条件,汇总了所有 @Anywhere 功能。
if(twitter.isConnected()){ $(".comments > .add > .author").html('<img src="'+ twitter.currentUser.data('profile_image_url') +'" /> <a href="http://twitter.com/'+ twitter.currentUser.data('screen_name') +'">'+ twitter.currentUser.data('screen_name') +'</a> | <a href="javascript:twttr.anywhere.signOut();">Sign out</a>'); twitter(".comments > .add").tweetBox({ label: 'What do you think about this article?', defaultContent: '#nettuts ' }); twitter(".comments > .add").followButton("nettuts"); }
@Anywhere 显然是 Twitter 对 Facebook Connect 的回应。他们希望将这个平台带到尽可能多的网络网站上;虽然该服务还很年轻,而且文档肯定还有待改进,但它绝对是有前途的!请向我们展示您在自己的网站中使用@Anywhere 做了什么!
Das obige ist der detaillierte Inhalt von6 einfache Schritte zur Nutzung des @Anywhere-Dienstes von Twitter. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!