incuna通知は、あなたのアプリに通知サポートを統合するためのDjangoのアプリは、シンプルな3ステップのプロセスです。
- あなたの通知タイプを作成
- あなたの通知テンプレートを作成する
- 通知を送信
の作成に関するお知らせタイプ
の
あなたは、データベース内のアプリケーションの通知タイプを作成するために一度create_notice_type（ラベル、表示、説明）を呼び出す必要があります。ラベルはタイプのために使用されるだけで内部短縮名で、ディスプレイは、ユーザーが通知タイプの名前として表示され、説明が簡単な説明あるものです。
例えば：
notification.create_notice_type（「friends_invite」は、「招待状は受信 "、"あなたが招待を受けている」）
自動的にこの通知タイプの作成を行う1つの良い方法は、syncdbを信号に接続され、アプリのためにmanagement.pyファイル、である。以下に例を示します。
django.confインポート設定から
_としてdjango.utils.translation輸入ugettext_noopから
settings.INSTALLED_APPSで「通知」の場合：
＆NBSP;通知輸入モデルからの通知など
＆NBSP;デフcreate_notice_types（アプリ、created_models、冗長性、** kwargsから）：
＆NBSP; notification.create_notice_type（「friends_invite "、_（「招待状をもらっ"）、_（） "あなたが招待を受けている」）
＆NBSP; notification.create_notice_type（「friends_accept "、_（「受け入れは受信"）、_（ "あなたが送信された招待状が受理された"））
＆NBSP; signals.post_syncdb.connect（create_notice_types、送信者=通知）
他に：
＆NBSP;印刷」NoticeTypesの作成をスキップ通知アプリが見つかりませんように」
通知がインストールされていない場合、あなたのアプリケーションは、とにかく進みますようにコードを条件節に包まれていることに注意してください。
ディスプレイと説明引数はugettext_noop使って、翻訳のためにマークされていることに注意してください。つまり、Djangoのmakemessagesの節で管理コマンドを使用することができますし、通知の国際化機能を使用します。
の通知テンプレートの
通知の実際のコンテンツ用に書き込まれることができます4異なるテンプレートがあります。
- short.txtは、予告の非常に短い、テキストのみのバージョン（電子メールの被験者のようなものに適している）である
- full.txtは、予告の長い、テキストのみのバージョン（メールボディのようなものに適している）である
- notice.htmlは、ウェブサイト上のユーザーの通知リストに表示されて、通知の短い、HTML版です
- full.htmlは、予告の長い、HTML版（現在は何のために使用されていない）である
これらはそれぞれ、通知/
例えば、通知/ friends_invite / notice.html含まれている場合があります：
{user_url％など％のURL profile_detailのユーザ名= invitation.from_user.username} {invitation_page％など％のURLの招待} {％負荷国際化％}
{invitation_from_user％などinvitation.from_userと％のblocktrans}
及び通知/ friends_full.txtが含まれている場合があります：
{％負荷の国際化％} {invitation_from_user％などinvitation.from_userと％のblocktrans} {invitation_page％など％のURLの招待状は} {{invitation_from_user}}は友人としてあなたを追加するために要求した。あなたは、彼らの招待を受け入れることができます。
のhttp：// {{current_site}} {{invitation_page}}
{％endblocktrans％}
通知を送信する際のコンテキスト変数が提供される。
の通知を送信するの
通知を送信する2つの異なる方法がある。私たちは、通知の送信の方法をブロックし、非ブロックのサポートを持っている。たとえば、通知を送信するための最も簡単な方法：
notification.send（[to_user]、「friends_invite "、{" from_user」：from_user}）
もう一つ注意すべきは、送信がsend_nowまたはキューのどちらかの周りの代理であるということである。彼らは皆、同じ署名を持っている：
送信（ユーザー、ラベル、extra_context、on_site）
パラメータは次のとおりです。
- ユーザーがに通知を送信するために、ユーザーオブジェクトの反復可能である。
- ラベルは、予告の種類を識別するために、前の手順で使用されるラベルです。
- extra_contentは通知にレンダリングするために使用されるテンプレートにカスタムコンテキストエントリを追加する辞書です。これはオプションです。
- on_siteは予告オブジェクトがデータベースに作成されているかどうかを決定するブール値のフラグである。
送信対キュー対send_now
最初の各が何を打破することができます。
send_now
これは、予告のelgibilityため、各ユーザーを確認し、実際に送信をpeformますブロッキング呼び出しです。
キュー
これは後で実行されるようにsend_nowするコールをキューイングします非ブロッキング·コールです。後で呼び出しを実行するには、emit_notices管理コマンドを使用する必要があります。
送信する
send_nowとキュー周りのプロキシ。それはNOTIFICATION_QUEUE_ALLという名前のグローバル設定から、その動作を取得します。デフォルトではFalseです。この設定は、あなたが送信するためにすべてのコールをキューイングするかどうかをコントロールを助けるためのものです。
今受け入れ、キーワード引数をキューにも送信する。デフォルトでは、各オプションはFalseであるグローバル設定を称えるためにFalseに設定されています。これは、あなたがそれをsend_nowまたはキューを呼び出す必要があるかどうかを呼び出しごとに上書きすることができます。
のオプションの通知サポートの
あなたは、再利用可能なアプリで通知を使用したい場合は、あなたはそれが通知を送信する前にインストールされている場合は、テストする条件句に通知の輸入をラップすることができます。その結果、あなたのアプリケーションまたはプロジェクトがまだ通知することなく機能します。
例えば：
django.confインポート設定から
settings.INSTALLED_APPSで「通知」の場合：
＆NBSP;通知輸入モデルからの通知など
他に：
＆NBSP;通知=なし
その後、以降：
通知の場合：
＆NBSP; notification.send（[to_user]、「friends_invite "、{" from_user」：from_user}）
の要件の
- パイソンます。
- ジャンゴます。
コメントが見つかりません