WebサイトでGravatarを使用する

確かに多くの人がGravatarインターネットサービスについて聞いたことがあるので、私は最近それを使用しなければならなかったので、少しの説明を書くことにしました。 サイトでの使用方法、その使用に関連するニュアンス、Gravataraの使用例を示します。 また、この記事はこのサービスの公式のPHP APIの翻訳であることに注意してください。



サービスの原則:



このサービスについて最初に聞いたとき、私はこれらの非常にアバターを変える信じられないほど膨大なAPIをすぐに想像しましたが、実際には違った結果になりました。 ユーザーのアバターを取得するには、彼のメールアドレスが必要です。これで、ほぼすべての作業が完了しました。 アドレスを見つけたら、最も簡単なバージョンでは2つの部分で構成されるリンクを形成する必要があります。

  1. サイト自体のアドレス: www.gravatar.com/avatar 。ここでアバターをリクエストできます。
  2. メールアドレスのMD5ハッシュについては、以下で詳しく説明します。


結果として、 www.gravatar.com / avatar / hashのようなリンクを取得する必要があります。 以上で、このリンクを使用すると、MD5ハッシュを取得した電子メールアドレスの単純な80x80アバターを取得できます。 このリンクは、任意のリソースで画像として使用できます。ファイル拡張子が必要な場合もあり、場合によってはハッシュの末尾に「.jpg」を追加します。その後、アバターのアドレスは次のようになります: www.gravatar.com/avatar / hash.jpg これはすべて理論であり、次に少し実践と例があります。



MD5ハッシュ:



PHPで標準のmd5()関数を使用する方法は誰もが知っています。フォーマットの方法を忘れた人や単に知らなかった人のために、以下に例を示します。



$hash = md5 ( $str );









応答としてハッシュ文字列をパラメーターとして渡すと、関数はMD5ハッシュを返します。これは将来アバターを受け取るために使用します。 しかし、それほど単純ではありません。実際には、改行や大文字が処理のために行に忍び込む可能性があります。これは、最終的に使用に適さないハッシュを取得するため、非常に望ましくありません。 したがって、メールアドレスのハッシュを生成する前に、次のように処理する必要があります。



$email = " " ;

$email = trim ( $email ); // .

$email = strtolower ( $mail ); // .

$email = md5 ( $email ); // .









このコードの作業後、結果が誤っていることを恐れずにハッシュを使用できます。 また、このコードフラグメントの短縮記録を以下に示します。



$hash = md5 ( strtolower ( trim ( $email ) ) );









この例では、 $ email変数には電子メールアドレスの生の文字列が含まれており、実行後、ハッシュ変数は$ has h変数で使用できる状態になっています。



パラメータ化のリクエスト:



それ自体では、このサービスはすでに非常に便利でユニークであり、最も重要なことには使いやすいです。 メールアドレスのみを知っているアバターを取得できるという事実に加えて、同じリクエスト内で追加のパラメーターを指定することもできます。 次に、値を要求するために使用可能なパラメーターについて説明し、その使用例を示します。



パラメータ: 説明: パラメータ名: パラメータ値:
大きさ このパラメーターは、受け取る画像のサイズを設定します。 s =またはサイズ= 0から512の整数
デフォルト画像 指定した電子メールアドレスに画像が関連付けられていない場合に受信する画像を指定します。 d =またはデフォルト= 404

mm

identicon

怪物

ワバター

レトロ
デフォルト画像、強制 デフォルトの画像を強制的にロードします。 f =またはforcedefault = y
年齢の評価 画像の年齢の評価を示します。指定された評価の画像がない場合、指定された評価またはデフォルトの画像より低い評価で画像が返されます。 r =または評価= g-任意のサイトで使用します。pg-失礼な、不快な言葉、暴力シーン、エロ画像を含むことができます。r-わいせつな表現、暴力シーン、裸体、薬物宣伝を含むことができます。x-コンテンツは成人のみに適しています。カテゴリー。




上記のパラメーターはすべて、 GETリクエストで値のペアとして送信されます。たとえば、 100x100ピクセルのアバターを取得するには、 www.gravatar.com / avatar / hash?s = 100またはwww.gravatar.com/avatar/のようなリンクを作成する必要がありますhash?size = 100 。 アンパサンド(&)を使用してパラメーターを結合することもできます。この形式では、リンクはwww.gravatar.com/avatar/hash?size=100?default=mmのようになります。 結果のリンクは、imgタグにすぐに使用できます。



概して、これですべてです。上のテキストでは、サイトやさまざまなCMSのプラグインでサービスを使用するのに十分な情報があります。 公式サイトから追加情報を入手できます。さまざまなライブラリ、PHP、およびその他のプログラミング言語をダウンロードして、このサービスを操作することもできます。



All Articles