ソースを表示

{{PAGENAME}}は、twitterにて簡易的なタイムラインの表示と投稿を行う、Webサーバ上で動作する軽量アプリケーション。twitterへのアクセスにはOAuth/xAuthを使用し、PC・携帯電話・PDAから同一のIFを提供する。

==対応バージョン==
このマニュアルは、頁末でダウンロード可能なVer.1.00に対応。

==動作環境==
;サーバ
:Linux/PHP5
;クライアント
:cookieを扱えるブラウザ

==インストール==
===twitteroauthのダウンロード===
[http://github.com/ github]より、abraham氏が作成・公開しているtwitteroauthライブラリをダウンロードしてください。
*http://github.com/abraham/twitteroauth
===スクリプト設置===
作成したディレクトリにTinyTimeLineのスクリプト'''ttl.php'''と、設定ファイル'''ttlsettings.php'''を設置してください。また、ダウンロードしたtwitteroauthライブラリも対象ディレクトリに設置してください。なお、TinyTimeLineのスクリプトファイル名は変更可能です。
*ttl.php
*ttlsettings.php
*OAuth.php
*twitteroauth.php
===ConsumerKey/Secretの取得===
twitterにアクセスして、ConsumerKey/Secretの取得を行ってください。
*https://twitter.com/apps
===AccessToken/TokenSecretの取得===
twitter/developにアクセスして、AccessToken/TokenSecretの取得を行ってください。
*https://dev.twitter.com/apps
===TinyTimeLineの設置時設定を実施===
TinyTimeLineの設置時設定を行います。'''ttlsettings.php'''の編集を行い、以下の通り設定を行ってください。

====動作設定====
twitteroauth.phpの設置場所をttl.phpと異なる場所に設置している場合、設置場所を示す必要があります。以下はその例です。
 require_once("./OALIB/twitteroauth.php");
前節まででtwitterより取得したConsumerKeyとAccessToken類を設定してください。ここに記述してあるものはサンプルなので、でたらめです。そのままで使用することはできません（が、取得した文字列は多分こんな長さの文字列なはずです）。
 $tockey = "Ejd83Ze9zWd7E28xg7E5gg";
 $tocsec = "2rnDYTq48wqd4RdCzjPEkJpPu3YGoPVhzebmlvD90ep";
cookieの設定も必要です。設置ディレクトリ、設置ドメイン、有効期限（秒）を設定してください。有効期限は、ブラウザ側での有効期限です。
 $md="/TTL/";
 $mi="www.yahoo.jp";
 $EXP=24*60*60 * 8;
認証用のパスワードファイル名を設定してください。既存の一般的な'''.htpasswd'''を流用することができます。
 $PF="./.htpasswd";
このスクリプトを使うときのタイトルを設定します。
 $CN="TinyTimeLine";

====表示関連設定====
TimeLineを表示する際に、$tllにて、一度に取得するTweetの数を変更可能です。200くらいまでは設定可能である模様ですが、そのまま動作速度やHTMLサイズに跳ね返ってくるので程々がお勧めです。
 $tll=40;
$txgでは、表示することができる世代数を設定できます。1であれば、過去世代を遡ることはできません。$tll×$txgの数はTwitterAPIにより制限されています。190くらいまではテストで確認しています。
 $txg=4;
テキストボックスの大きさを示します。使用している携帯電話やPCブラウザなど、好みに応じて変更してください。
 $fsz="36";
テキストボックスに対する入力可能文字数（bytesではありません）を設定することができます。InternetExplorerではあまり正確な動作はしないかもしれません。
 $fmx="140";
tweetできる最大文字数を設定することができます。140より大きくすることができますが、尻が切れたりエラーになったりとその結果は一定しないので、変更することはお勧めしません。
 $tmx="140";
TimeLineの表示を抑制することができます。初期状態はFALSEですが、TRUEに変更すると抑制されます。その状態でも投稿はできます。
 $NOTL=FALSE;

====認証設定====
'''.htpasswd'''を設定する必要があります。記述ルールは以下の通りです。
 username:password:AccessToken:AccessTokenSecret
passwordはdes暗号化されている必要があります。以下のサンプルを示しますが、ConsumerKeyと同様でたらめです。そのままで使用することはできません（が、取得した文字列は多分こんな長さの文字列なはずです）。
 zerowing:ZWMCOjVZ/V7ac:90185427-4Vj3Yq5n6GBGfENxndMMstVFVzJFRp0O1lRaEqA2L:pi7tWI1mDh8o6qzjwBg6yZ4UqxwwB474eLmxGcssoSN
DES暗号化については以下の通りコマンドラインから入力することで取得することができます（"ZW"の部分は任意の2文字以上の英数文字を入力してください）。
 % php -r 'echo crypt("AYBABTU","ZW")."\n";'
 ZWMCOjVZ/V7ac
 %
複数設定することも可能です。その場合はAccessToken/TokenSecretを別々に取得する必要があります。

==使い方==
===ログイン===
このスクリプトをブラウザから見ると、認証を求められます。前節で設定したusernameとpasswordを入力し、「Login」ボタンを押すとログインできます。
;ログイン有効期限
:ログインセッションはcookieで与えられ、ブラウザを終了させてもcookieはクリアされません。設定項目 '''$EXP'''にて変更可能ですが、初期状態では8日間に設定されています。サーバ側のセッション有効期限についてはPHPに関するサーバ設定で制御されています（一般的には未使用のセッションは24分ごとに1/100の確率で削除されます。
次回以降のログインでは、クライアント・サーバのどちらも有効期限が切れていなければログインは不要で、すぐにタイムラインが表示されます。

===ログアウト===
ログイン後のいずれかの画面で「Logout」をクリックすれば、ログアウト処理が行われます。次回以降、画面を開いたときにログインする必要があります。また、セッション期限切れの場合は'''EXPIRE'''と、ログイン失敗時には'''NG'''と、ログインしていない場合は'''NOTLOGIN'''と表示されます。

===タイムライン===
[[image:TTL091V.png|128px|thumb|right|TTL V0.91のスクリーンショット]]
ログイン後は、右側サムネイルのような画面が表示されます。タイムライン抑止設定をしていれば、入力フォームのみ表示されます。「Timeline」をクリックすると最新のタイムラインが、「1/2/3」をクリックすると1～3世代前のタイムラインが、「NextXX」をクリックすると現在表示しているものより1世代前のタイムラインが表示されます。

===投稿===
テキストボックスに入力し、「Twit」ボタンをクリックすると投稿できます。twitterWebなどで表示される投稿アプリケーション名には、ConsumerKey取得時に設定したアプリケーション名が表示されます。

===Reply===
タイムライン上の'''Re'''をクリックすると、Re画面が表示されます。Re対象となった1件のみ表示され、テキストボックスにはメッセージとリプライ先ユーザ名が予め入力されています。ここでテキストボックスに入力し（あるいはそのまま）「Re」ボタンをクリックすると投稿されます。通常の投稿との違いは以下の通り。
*入力用のテキストボックスに、予めユーザ名と引用メッセージが入力されています。
*リプライ元のメッセージIDが付与されているので、公式のReと同等になります。

===QT===
タイムライン上の'''QT'''をクリックすると、QT画面が表示されます。QT対象となった1件のみ表示され、テキストボックスにはメッセージとリプライ先ユーザ名が予め入力されています。ここでテキストボックスに入力し（あるいはそのまま）「QT」ボタンをクリックすると投稿されます。Reとの違いは以下の通り。
*Reと異なり、メッセージIDの紐付けが行われないので、返信扱いにはなりません。ゆえに、全てのフォロワーのタイムラインに表示されます。
*公式RTとの違いについても同様で、リツイート扱いにはなりません。

==ライセンス==
*このスクリプトの利用は自由です。使用、改変、配布、引用、いずれにも許諾不要です。配布は有償無償を問いません。
*このスクリプトの利用に関する問題の責はJUDが負うものではありません。

==問い合わせ==
質問・苦情・要望は [http://twitter.com/Judstyle Judstyle - twitter] まで。

==Download==
*[http://judstyle.jp/jswiki/images/3/32/TTL102.zip Version.1.02]
*:自分宛statusを表示させる機能を追加（@username相当）。メニューの「@me」で遷移。ショートカットは8番。
*:バックスラッシュでエスケープされた文字がそのままPOSTされるバグをfix
*:削除statusがカラ表示されるバグをfix
===Old===
*[http://judstyle.jp/jswiki/images/6/6a/TTL101.zip Version.1.01]
*[http://judstyle.jp/jswiki/images/c/c7/TTL100.zip Version.1.00]
*[http://judstyle.jp/jswiki/images/0/07/TTL097.zip Version.0.97]
*[http://judstyle.jp/jswiki/images/0/00/TTL096.zip Version.0.96]
*[http://judstyle.jp/jswiki/images/9/95/TTL093.zip Version.0.93]

[[Category:TTL]]
[[Category:twitter]]