人気のあるCMSでのWebサービスの統合

この記事では、CMSを短時間で学習し、そのための拡張機能、モジュール、またはプラグインを作成する方法についての推奨事項を示し、 Cackleサービスをこれらのシステムに統合した結果と経験について説明します。 この記事は、cmsシステムとのサービス統合を行うか、単にモジュールを作成する人向けのガイドになります。



どのような種類のcmsを統合するかを決定する前に、ユーザーの統合要求に関する統計を収集する価値があります。どのcmsが最も人気があるかを示しています。





これらの統計に基づいて、これらのcmsにモジュールを埋め込む効果は、その人気に統計的に比例すると仮定できます。 これは、さらに学習する各cmsに当てはまります。



統合により、サービスをcmsに便利に埋め込み、その使用の利点を最大限に活用できます。 理想的な解決策は、数回クリックするだけでプラグインをインストールすることです。 許容される解決策は、mod-cmsスクリプトを変更するcmsを完了するための指示です。 私たちのプロジェクトでは、Cmsに対するCackleコメントの統合には通常、次の点が含まれます。



-Cackleサービスからローカルデータベースへのコメントの同期は5分ごと

-SEOのHTML表示

-既存のサイトコメントをCackleにエクスポートする

-再同期の可能性（ローカルデータベースへのコメントのコピーの繰り返し）

-SSO（ユーザーの承認）

-メインページのコメントカウンター

-最近のコメントウィジェット



モジュールのこれらすべての要件には、タイマーの実装、APIを介したリクエストによるコメントの受信、データベースへの保存、特定のページのcmsテンプレートでのjsウィジェットの表示、APIキーを入力するための管理パネル、およびその他の設定が含まれます。



Cackleコメントサービスを次のcmsシステムに統合しました。

Wordpress、Drupal、DLE、InstantCms、Joomla、Bitrix。



次に、時系列で、各cmsの統合エクスペリエンスを説明します。

ワードプレス

開発

プラグインを作成するための詳細なドキュメントがあります。 プラグインを初期化するには、必要なフックを見つけるだけです：アクションとフィルター-codex.wordpress.org/Plugin_API comments_templateを使用してテンプレートをコメント付きで表示し、comments_numberを使用して投稿のコメント数を表示し、admin_menuを使用して管理パネルにメニューを追加し、wp_footerを使用してjsカウンターをフッターに追加します。 時間の同期には、タイマーによる任意の関数の開始を実装するwp_schedule_single_event関数を使用します。



コードに慣れるには、プラグインをダウンロードして、こちらの説明をご覧ください- ワードプレスのプラグイン

テスト中

WPのテストは、異なるバージョンで実行する必要があります。 モジュールで使用されているデータベースに関数またはテーブルがない場合に、状況が発生する可能性があります。 ここでは、次のチェックを実行できます。

if (version_compare(get_bloginfo('version'), '2.9', '>=')){

..

}







古いバージョンをサポートする必要がありますか？ そう思う。 多くのブロガーは、次のように古いバージョンに座っています 更新は多くの場合、テンプレートファイル、エンジン、多くのプラグインの変更で終了し、すべてを再構成する必要があります。

発売日

プラグインのリリースは、正しいバージョンでsvnタグにコミットされます。 メインファイルとreadmeファイルのモジュールのバージョンに特に注意を払う必要があります。 モジュールはモデレートなしでリリースされます。 svn WordPressへのアクセスを許可する時間は約3〜5日です。

結果

ワードプレスの場合、特定の時点でのプラグインの使用に関するオープンな統計があります-wordpress.org/plugins/cackle/stats 。 リリース直後には、1日あたり30〜50回のダウンロードがありました。 現時点では、ダウンロードの総数は約20,000です。ユーザーの80％はお客様です。

Drupal

開発

_block_view（）ページのブロック表示フックで初期化が行われます。 カスタムテンプレートの接続とjsファイルの追加には特に注意が必要です。 変数を使用できるように、変数を正しく渡すことが重要です。

jsを接続するには：

 drupal_add_js(array( 'cackle' => array( 'cackle_mc_site' => variable_get('cackle_mc_site', NULL), 'node_id' => $node->nid, ), ), 'setting');
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

js自体の内部で、mcSiteはDrupalオブジェクトのプリロードされたプロパティから取得されます。

 var mcSite = Drupal.settings.cackle.cackle_mc_site;
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

テンプレートは次のように接続されます。

 $template = theme('cackle_custompage_template', array( //    'obj' => $obj, 'nodeid' => $nodeid, 'has_curl' => $has_curl) );
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

テンプレートフック自体：

 function cackle_theme() { return array( 'cackle_custompage_template' => array( 'template' => 'cackle_template', 'arguments' => array( 'obj' => NULL, 'nodeid' => NULL, 'has_curl' => $has_curl ), ), ); }
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

また、これらのフックは、モジュールを取り外して再インストールするときにのみ接続されるという事実にも注意を払う必要があります。



コードに慣れるには、プラグインをダウンロードして、説明を参照してください-drupalのモジュール

発売日

モジュールをdrupal Webサイトのディレクトリに配置することは、かなり難しいクエストであることがわかりました。 最初に、サンドボックスプロジェクトが作成されます。 gitに注いだ。 その後、彼はレビューに行きます。 このプロジェクトはkitのように投げられています。 ブラウザが最初に記述することは、自動コード検証のエラーと警告-pareview.shです。 スペースまで、カンマまで、タブの代わりに2つのスペースまで、すべてが重要です。 そして、コードを編集する前に。 その後、すべてが修正され、それについてかなり報告すると、特定の「メイン」が表示され、書き込みます：私たちは今忙しいので、レビューを手伝ってください。プロジェクトをレビューする時間とボーナスdrupal.org/ node / 1975228その本質は、プロジェクトをサンドボックスからフルプロジェクトにアップグレードできる人からレビューを取得する前です-つまり カタログで利用できるプロジェクトは、他のプロジェクトのレビューを3回行う必要があります。 欠陥が見つかった場合、プロジェクトは修正のために送信されます。タグボーナスレビューを行うには、さらに3つのレビューを行う必要があります。



最初に注意するレビューア：

• データベースを操作するには、ネイティブAPIを使用する必要があります
• モジュールで純粋なhtmlを生成することは固く禁じられています。そのためには、テンプレートを使用する必要があります
• check_plain（）関数を使用してhtmlを表示するときにXSSを確認します
• モジュールのパーミッションを正しく設定する-引数にアクセスする

ここでそれがどうであったかを見ることができます-drupal.org/node/1824770

ボーナスレビューを取得するには、パルスに遅れないようにする必要があります...レビュー用の新しいプロジェクトが表示されたらすぐに、トップリストからエラーと不正確さをすばやくマージして探す必要があります。 これらすべてを完了した場合、アカウントにはコミュニティモデレーションなしで完全なプロジェクトを作成する権利が与えられます。 最後の警告：後で機能を向上させることを目的として、モデレーションなしで小さなプロジェクトをレビュー用に数行で投稿することにより、完全なプロジェクトを作成する権利を取得することはできません。

また、apiの説明では、このフックまたはそのフックがどのように機能するかを理解するために多くのエラーを見つけることができるので、コアdrupalモジュールを直接確認することをお勧めします。

結果

カタログからは、たった241のダウンロード（ drupal.org/project/cackle）と個人アカウントからのデモ版の約100ダウンロードが常にあります。 統計によると、Drupalモジュールは現在150のサイトのどこかで使用されています。

ウィックス

Wixは人気のあるWebサイトビルダーです。 このサイトビルダーの開発者自身が私たちに連絡し、市場向けのアプリケーションの作成を提案しました。 プラットフォームでは3000万以上のサイトが作成されたのは魅力的でしたが、これはロシアではまだ珍しいことです（4月にこの統合を行い、ロシアのドメインの統計情報はありませんでした）。

開発

ウィジェットが市場に参入するためには、暗号化されたパラメーターを受け入れ、対応するウィジェットを表示する複数のコントローラーをホスト上に作成する必要があります。 Wixアプリケーション自体を作成するとき、2つのアドレスのみが挿入されます：/ widget-ウィジェット自体、/ settings-ウィジェット設定。 彼らはphpに既製のサンプルを持っています-github.com/wix/wix-php-rss-feed-app 。これはホスティングでこのアプリケーションを上げるのに役立ちます。 現在のライブラリを慎重に置き換える必要があるのは、あなただけです 最近のプレフィックスでさえ、古いAPIライブラリを提供します。

発売日

市場にアプリケーションを提出するときに発生する可能性のある問題：

-サービスでのユーザー登録は、サーバー上で生成する必要があるこれらのまさにウィジェットを通じて、wixサイトで直接行われる必要があります

-サービスへの登録の確認を要求することはできません

-ウィジェットのすべての設定は、CackleではなくWixアプリケーション自体で行う必要があります

-独自の関税がある場合は、Wixに転送する必要があります。 Wixウェブサイトでのサービス料金を支払います

最初の3つは、ユーザーが自分のサイトにとどまり、別のサイトで設定を行うことを神に禁じたり、メールに行ったりしてはならないという考えに基づいています。

後者は、Wixが販売に対して30〜40％の範囲で報酬を受け取ることを前提としています。

すべてがうまく機能していないこと、そしてシステムを大幅に変更する必要があることを説明しようとするすべての試みに対して、「Wixでは違います」という答えが1つあります。 そして明らかに彼らはそれを誇りに思っています。

その結果、彼らは市場への投稿を拒否し、すでにユーザーでありWixを使用しているユーザーへの指示に限定されました。

Dle

開発

DLE APIは最も短いものです。 もちろん、drupalやwordpressのような強力なフックはありませんが、コードを少し変更するだけで、必要なモジュールをきれいに埋め込むことができます。

開発したモジュールは、目的のテンプレートに1行で接続されます-

 {include file="engine/inc/cackle_template.php?newsid={news-id}"}
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

これにより、cmsから分離してモジュールをテストし、ビルドすることができます。 実際、私たちは一般的なソリューションを構築しました。 モジュールの例の管理ページを呼び出すことにより、モジュール自体がインストールされます。

http：// [サイトのルートパス] /admin.php?mod=cackle_admin

dleで定義されたデータベース定数（DBHOST、DBNAME、DBUSER、DBPASS）により、pdoで作成された一般的なソリューションとデータベース接続を完全に使用することができました。



コードに慣れるには、プラグインをダウンロードして、説明を参照してください- モジュールfor dle

発売日

最後に待っていた最も楽しい報酬は、DLEに多数のサイトがあり（検索で簡単に検索できる）、モジュールに関する情報を完全に無料で投稿できることです...そして、これらは1日あたり500から3500人のトラフィックを持つ良いサイトです。 また、完全に無料で、モジュールはメインページdle-new.ruに配置されました。 これらすべてが非常に優れたコンバージョントラフィックをもたらしました。

開発期間

ajax管理パネルと2つのエンコード（utf8、win1251）をサポートする一般的なソリューションの開発を含む3日間

リリース時間：1週間以内

結果

1か月あたり150回のインストール

インスタント

開発

プラグインを作成するための公式ドキュメントはまったくありません。 代わりに、完成したモジュールを確認することをお勧めします。 ネットワークには、events'ovのリストが散らばっています（www.instantcms.ru/blogs/haki-patchi-moduli-plaginy-i-prochie-dorabotki-dvizhka/spisok-vseh-event-ov-sistemy.htmlの1つです）コードに 多くのイベントには小さなバグがあり、独自のピースを追加できるHTMLのオブジェクトを返さないか、まったく動作しない場合があります。 コードを埋め込むことができたコンテンツの種類についてのみ：記事、ブログ、写真。

プラグイン設定を含む管理パネルは、プラグインパスにねじ込まれなければなりませんでした。

 foreach($GLOBALS['cp_pathway'] as $key => $value){ if(isset($GLOBALS['cp_pathway'][$key]['title'])) { if ($plugin_id&&$plugin_name='p_cackle'){ $this->events[] = 'SHOW_CACKLE_ADMIN'; cmsCore::callEvent('SHOW_CACKLE_ADMIN', $this->showCackleAdmin()); } } }
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

コードに慣れるには、プラグインをダウンロードして、こちらの説明をご覧ください-instantCmsのプラグイン

発売日

このCMSにはクライアントからの統合要求がかなりありましたが、このCMSの統計を見ると、統合を急ぐ必要はありませんでした。 モジュールは顧客の1人によって注文されました。 インデックスのセットアップを行い、クライアントがinstantCmsブログにモジュールを投稿しました。 次に、このモジュールに他のすべての機能（export、sso、counter）を含め、プラグインのリストに追加しました。 テーマ別のサイトやフォーラムにこのモジュールに関する情報を投稿できるようにする予定でしたが、もっと真剣に見てみると、何もないことに気付きました。 さらに、ブログでのレビューと議論は、ユーザーが無料のcmを使用するという事実に照らして、有料サービスを使用することの妥当性に帰着しました。

開発期間

3日間。 ほとんどの時間はイベントの把握に費やされました。

結果

ダースインストール。

Joomla

開発

プラグインを作成するための公式ドキュメントがあります。 プラグインのパラメーターはxmlを通じて定義され、便利なメッセージのシステムを通じてローカライズされます。 コンテンツの出力の前後に便利なイベントdocs.joomla.org/Plugin/Events/Contentがあります。 便利なテストと開発のために、コンテンツの種類を理解し、すべての主要なコンテンツを作成するためにテストする必要があります。



コンテンツコンポーネントの$ view == 'article'

$ view ==コンポーネントK2の「アイテム」

viruemartの$ view == 'productdetails'

$ view == 'frontpage'メインページ

$ view ==お気に入りの「特集」

$ view == 'section'および$ view == 'category' for categorys

さらに、イベントの処理中に、コンテンツのタイプとコンポーネントの名前を判別し、通常の状態でモジュールに必要な要素を表示できます。

$ view = JRequest :: getCmd（ 'view'）; $ option = JRequest :: getCmd（ 'option'）;



コードに慣れるには、プラグインをダウンロードし、説明を参照してください-plugin for joomla

テスト中

コンポーネントk2、Virtuemartを含む2つのバージョン2.5、3.0でテストしました（3.0の場合はなし）

発売日

また、joomlaのextension dirについても言及する必要があります。 まず、ログインにバグがあります...すべてのフォームが機能するわけではありません...フォーラムとサイトで異なる登録があります。 プラグインの送信ボタンは、サブセクションのディレクトリ自体にあります。 提出モジュールのちょっと変わった形式。 1か月前の新しいリリースでの行は86でしたが、その月は70に移動しました。今月には、216のアプリケーションが既にキューにあります。

私たちにとって、このソリューションの開発目標は、サードパーティのプラグインを放棄することでした。

1C bitrix

開発

アプリケーションの展開の開始時に、utf-8にインストールすることが困難になりました。 サーバーを長時間設定する必要がありました。

モジュールの開発に関するドキュメントは、モジュールの構造の説明と例で優れています。 Bitrixへの統合のために、通常、コンポーネントを含むモジュールが作成されます。 ユーザーは、サイトの任意のページでビジュアルエディターを介してコンポーネントに接続できます。 問題の1つは、block_idとして材料識別子を取得することでした。 代わりに、マテリアルのパスを返すGetCurPage（）関数を使用する必要がありました。 一般的なソリューションの管理パネルは、パラメーターを保存する機能をわずかに変更するだけで、モジュールの管理パネルに簡単に移動できました。

 COption::SetOptionString("cackle.comments", $param, $value); COption::GetOptionString("cackle.comments", $param);
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

これまでのコードは、Cackle管理エリアでのみ確認できます。 これを行うには、 デモ登録を使用できます。

発売日

リリースするには、パートナーシップ申請書を送信する必要があります。 その結果、テクノロジーパートナーのステータスが割り当てられます。 開発用の無料ライセンスを取得できることを望んでいましたが、30日前のデモ版で開発を実施する必要があるとサポートから回答がありました。

リリースするときは、名前を遵守することが重要です。 このcackle.commentsがあります。 この名前のモジュールは、設定と更新、モジュール設定（option.phpがある場合）、およびドットがない場合、Bitrixモジュールでのみ表示されることに注意してください。 市場では、平均して7日間（Tech。Supportによると）、実際には9日間でさえ、モデレートがかなり長い間行われています。 開発時間を短縮し、データベース内のpdoコネクタでライブラリを使用しようとしました。 その結果、テスターに​​エラーが発生しました。 このモジュールは有効化されておらず、誰もがこのモジュールを持っているわけではないという確信の下で（PHP 5.2に付属していますが）、データベース層全体をBitrix APIに書き換える必要がありました。 これでモジュールは再びモデレートされ、完了時にモジュールは再びキューの先頭にあるようです。

最新の推奨事項

迅速かつ成功した統合のための一般的な推奨事項：

• 独自の柔軟なライブラリを持っている
• 同様の機能の2-3モジュールがどのように書かれているかを見る
• モジュールの作成については、もしあればドックを参照してください
• ドックがCMSコード自体を見て、モジュールの初期化に必要なイベントを見つけるのに十分でない場合
• 実装後、異なるバージョンのcmsおよび異なるテンプレートでテストする

ツールとして、OpenServerサーバーとcmsごとに個別のフォルダーを使用します。



私たち自身がcmsとの統合を行っています これにより、顧客サービスの品質が向上します。 問題が発生した場合、クライアントを支援する機会が常にあります。



さらに、他のCMSとの統合を行う予定です。 近い将来、これらはNetcatとUMIです。 このトピックが興味深い場合は、統合の説明を続けます。