WordPress Download Leader

MTS Download Leader Plugin for WordPress

自分のプログラムを公開するにあたって、どのくらいダウンロードされるのか興味があるところです。画像や音楽を創作して公開しようと思われている方も、きっと同じ気持ではないでしょうか。そこで、ダウンロード回数が分かる、WordPress のダウンロード補助プラグインを作ってみました。

機能は、ダウンロード用のアンカーからダウンロードすると、日時、IPアドレス、ユーザーエージェントを保存するものです。アンカーは、ファイル名とタイトルや保存先を設定したマスターデータから、記事やページに簡単に貼り付ることができます。

管理画面の機能は、ファイル保存先のディレクトリを登録する「設定」と、ダウンロードファイルの情報を登録・編集・削除、およびダウンロード回数を表示する一覧しかありません。

ここでは、インストールから使うまでを簡単に説明します。なお、お作法に従って国際化対応してみました。間違ってダウンロードしてしまった外人さんのために、単語を並べただけの英文を併記させていただきます。稚拙な英文をインターネット上に晒すのは、大変お恥ずかしいのですが、どうぞご容赦ください。

バグの報告、誤りの指摘はもとより、機能追加要望、励ましのコメント大歓迎です(^o^)。叩かれることに対しては、至って脆弱のためご賢察下さい m(_ _)m。

MTS Download Leader is a plugin of WordPress. It has features to download a file and count the number of downloading.

インストール – Installation

以下の4ステップです。

In the same way other installations of plugins, it’s easy to install 4 steps the following.

  • ダウンロード
    Download mts_download_leader.
  • 解凍
    Expand the zip file.
  • wp-content/pluginsディレクトリへmts_download_leaderディレクトリをアップロード
    Upload mts_download_leader folder and files to your wordpress site wp-content/plugins directory using FTP.
  • 管理画面からプラグインを「使用する」に切り替える
    Activate mts_download_leader.

設定 – Configuration

Menuダウンロードファイルの保存場所を決め、管理画面の「設定」でディレクトリパスを設定して下さい。インストール直後は、Wordpress がインストールされたサイトのディレクトリが登録されています。

Define the directory loading download files, then save the directory path on the configuration page. It is set wordpress site direcotry when installed.

ファイル情報の登録 – Save file infromation

ダウンロードのファイル情報を、管理画面の「新規登録」から登録して下さい。ファイル名は、実際のファイル名と異なっても構いません。実際のファイルの場所は、ファイルパスで指定して下さい。タイトルが記事やページで表示されるアンカーとなります。ファイルは、指定場所に FTP などでアップロードして下さい。

Save download file informations on the ‘Add file’ page of the controll menu. File name is the name using in href string. Set the real file directory path to File path. Title will be displayed on posts or pages for anchor string. Don’t forget upload the download file to the save directory on your site.

リンクの張り方 – How to set anchors on posts or pages

WordPress のショートコード機能を利用します。例えば、ファイル名を「sample.zip」とした場合、

It is used the wordpress shortcode feature. For example, file name sample.zip

[link_download_file filename="sample.zip"]
[link_download_file filename="sample.zip" numberof="1"]
[link_download_file filename="sample.zip" numberof="1" nolink="1"]
[link_download_file filename="sample.zip" numberof="1" count="1"]
[link_download_file filename="sample.zip" numberof="1" class="dl-anchor" title="サンプル"]

と、記事またはページ上に記入して下さい。そのページを表示すると、

Input data like above, so replaced the string like below string when the post or page is displayed. xxx means the number of downloads.

<a href="File path">Title</a>
<a href="File path">Title</a> (xxx)
Title (xxx)
2
<a class="dl-anchor" href="File path">サンプル</a> (xxx)

と置き換えられます。(xxx)はダウンロードされた回数の表示です。

テンプレート上で関数を利用する方法 – How to use the function

テンプレート上で次の関数を利用して、ダウンロード登録ファイルの情報を取得することができます。

<?php mtsdl_download_data(filename, column); ?>

「filename」はショートコードと同様です。「column」は、指定しないか、または「link」か「count」です。

<?php echo mtsdl_download_data('sample.zip'); ?><br />
<?php echo mtsdl_download_data('sample.zip', 'link'); ?><br />
<?php echo mtsdl_download_data('sample.zip', 'count'); ?><br />

とすると次のように出力されます。

Title (2)
http://web site url/mtsdownload/sample.zip
2

一覧 – List

管理画面の一覧表示に、登録したファイル情報、編集、削除へのリンクがあります。削除を実行すると、ファイル情報と一緒に、ダウンロード情報もデータベースから削除されます。

Files informations are displayed with the number of downloading, edit and delete anchors on the File list of control page. If you delete a file data, the file information and its download informations are deleted from database.

アンインストール – Uninstall

プラグインの利用を止めたとき、プラグインのアンインストールを実行すると、Wordpress に登録されたデータベースのテーブル、オプションデータが全て削除されます。

If you uninstall MTS download leader, database tables and option datas of this plugin are deleted all.

Any suggestions or advices to this plugin are welcome. Of course points out of my poor English, too.
Thank you (^o^)/.

(091104)

Ver.0.7.0 アップデート情報 – Update informations
15件以上登録すると一覧ページは切り替えとなりますが、切り替え表示ができなかった不具合があったため修正しました。

その他、新規追加直後の入力フィールドは登録した値をそのまま表示するようにしてましたが、そのままもう一度保存すると同じデータで二重登録されました。今回のアップデートでは、同じ「ファイル名」を持つデータが二重登録されないように、データベースのテーブルに「UNIQUE KEY」指定を追加しました。

このため、「debug」が「true」のとき2重登録をしようとすると、「WordPress」からエラーが表示されるようになります。

また、入力フィールドに前回入力した情報をクリアするための設定を、設定画面で指定できるようにしました。

(100117)

Ver.0.7.1 アップデート情報 – Update informations
一覧表示のダウンロード回数を表す項目名「DL」に、ダウンロード回数によるソート表示(降順・昇順)するリンクを追加しました。また、一覧リスト下部に表示されるページナビゲーションを、上部でも表示するようにしました(kenさん、ご協力ありがとうございました)。

アップロード手順は、繰り返しの説明になりますが管理画面からプラグインを停止し、FTPでアップロード後(上書きOK)、「使用する」をして下さい。

(100124)

Ver.0.7.2 アップデート情報 – Update informations
インストール直後の、ダウンロード情報が何も登録されていないとき「ファイル一覧」が実行されると、内部でSQLエラーが発生していました。エラーが発生しないように修正しました。

また、管理画面の「設定」ー「パーマリンク設定」において、デフォルトが選択されているとリンクエラーが発生して動作しなかったのを、ダウンロード動作するように修正しました。

アップロード手順は、繰り返しの説明になりますが管理画面からプラグインを「停止」し、FTPでアップロード後(上書きOK)、「使用する」にして下さい。

(100625)

Ver.0.7.4 アップデート情報 – Unpdate informations
ショートコード(link_download_file)で取得できるデータの種類を増やしました。追加パラメータは、「nolink」、「count」、「title」、「class」です。使用方法は、このページのリンクの張り方をご覧下さい。

また、投稿やページの中ではなく、テンプレート上で PHP を利用してデータを取得できる関数、「mtsdl_download_data()」を追加しました。パラメータは、ダウンロードファイル名と取得したいデータ名を渡します。使用方法は、このページのテンプレート上で関数を利用する方法をご覧下さい。

アップロード手順は、繰り返しの説明になりますが管理画面からプラグインを「停止」し、FTPでアップロード後(上書きOK)、「使用する」にして下さい。

(101225)


WordPress Version: 2.8.6, 2.9.1, 2.9.2, 3.0, 3.0.1, 3.0.3
Download: [link_download_file filename=”mts-download-leader-0.7.4.zip”]
Old program: [link_download_file filename=”mts-download-leader-0.7.2.zip”]