こんにちは 今日は、サイトでのファイルアーカイブの作成についてお話ししたいと思います。 
      
        
        
        
      
    
      
        
        
        
      
     残念ながら、このための汎用ツールは見つかりませんでした。有名なスニペットFileDownload v2.6がありますが、2007年に最後に更新されました。 また、MODxに関するサイトの1人がアーカイブを作成し、最後にパブリックドメインに置くことを約束していることも聞きました。 ただし、タスクがそれほど難しくない場合(たとえば、テクニカルサポートセクションでダウンロードするための説明を含むファイルの単純なリスト)、FileDownloadスニペットも非常に適しています。 
      
        
        
        
      
    
      
        
        
        
      
     
      
        
        
        
      
    
      
        
        
        
      
    
      
        
        
        
      
    
      
        
        
        
      
     手始めに、それを試していない人: 
      
        
        
        
      
    
      
        
        
        
      
     ファイルダウンロード2.6 
  -modxcms.comのスニペットリンク 
      
        
        
        
      
      説明 
      
        
        
        
      
    
      
        
        
        
      
     技術情報: 
      
        
        
        
      
     タイトル:FileDownload 
      
        
        
        
      
     バージョン:2.6 
      
        
        
        
      
     サポート:MODx Evo 1.xx以下 
      
        
        
        
      
     著者:カイル・ジェブカー、アダム・ストゼレツキ 
      
        
        
        
      
    
      
        
        
        
      
      FileDownloadスニペットは、ユーザーがダウンロードするために指定されたディレクトリからファイルのリストを表示します。  FileDownloadプラグインと組み合わせて使用すると、ダウンロードされたファイルを直接指すのではなく、安全なリンクを生成し、ダウンロード数をカウントできます。 
      
        
        
        
      
     このスニペットはテンプレートシステムをサポートし、さまざまなニーズに合わせて変更するための十分な数のパラメーターを備えています。 
      
        
        
        
      
    
      
        
        
        
      
      スニペットの主な機能: 
      
        
        
        
      
      •ダウンロード数をカウントします。 
      
        
        
        
      
      •チャンクからファイルの説明を表示する機能。 
      
        
        
        
      
      •チャンクで完全にカスタマイズ可能な外観。 
      
        
        
        
      
      •訪問者はサブディレクトリを表示できます。 
      
        
        
        
      
      •ファイルの種類を表示する機能。 
      
        
        
        
      
      •作成日とファイルサイズを表示する機能。 
      
        
        
        
      
      •ファイルへのアクセスをグループごとに区別する機能。 
      
        
        
        
      
    
      
        
        
        
      
      インストール: 
      
        
        
        
      
      •filedownloadフォルダーをスニペットディレクトリにダウンロードします(フォルダーにはfiledownload.class.inc.php、data.db.class.inc.php、filecount.txtの3つのファイルが必要です)。 
      
        
        
        
      
      •新しいスニペット-FileDownloadを作成します。 
      
        
        
        
      
      •FileDownload2.6.phpファイルの内容を新しいスニペットにコピーします。 
      
        
        
        
      
      •使用するチャンクを作成します。 
      
        
        
        
      
      •ファイルのリストを表示するには、スニペットを呼び出します。 
      
        
        
        
      
    
      
        
        
        
      
      呼び出し例: 
      
        
        
        
      
     ファイルを含むディレクトリを示す単純な呼び出し: 
      
        
        
        
      
      [!FileDownload?  &getFolder = `assets / snippets / filedownload`!] 
      
        
        
        
      
     ファイルとサブディレクトリを使用する権限を持つディレクトリを示す単純な呼び出し: 
      
        
        
        
      
      [!FileDownload?  &getFolder = `assets / snippets / filedownload`&browseDirectories =` 1`!] 
      
        
        
        
      
    
      
        
        
        
      
      「開始する」パラメータのリスト: 
      
        
        
        
      
    
      
        
        
        
      
      &getFolder 
      
        
        
        
      
      デフォルト:なし 
      
        
        
        
      
      値:ディレクトリのコンマ区切りリスト 
      
        
        
        
      
      説明: getFolderパラメーターは、スニペットがスキャンするディレクトリーを決定するために使用されます。 複数のディレクトリが指定されている場合、&browseDirectoriesオプションは機能しません。 ディレクトリを入力する際の文字「/」を追加する必要はありません。 
      
        
        
        
      
      注: 
      
        
        
        
      
      FileDownloadプラグインプラグインで使用する場合、ディレクトリはTVパラメーターFileDownloadFolderで指定され、スニペットを呼び出すときのパラメーターでは指定されません。 
      
        
        
        
      
      例:アセット/スニペット/ファイルダウンロード 
      
        
        
        
      
    
      
        
        
        
      
      &browseDirectories 
      
        
        
        
      
      デフォルト: 0 
      
        
        
        
      
      値: [1 |  0] 
      
        
        
        
      
      説明:このパラメーターにより、ユーザーは、&getFolderで指定したディレクトリー内のサブディレクトリーを表示できます。 このパラメーターを使用する場合、テンプレートの次のセクションが関係します:親とフォルダー。 
      
        
        
        
      
    
      
        
        
        
      
      &getFile 
      
        
        
        
      
      デフォルト: null 
      
        
        
        
      
      値:ファイル 
      
        
        
        
      
      説明:パラメーターを入力すると、スニペットは指定されたファイルのみを出力します。 この場合、getFolderパラメーターは引き続き必要であり、getFileで指定されたファイルは指定されたディレクトリになければなりません。 したがって、このパラメーターを使用すると、ディレクトリ内の特定の1つのファイルのみをダウンロードおよびダウンロードできます。 
      
        
        
        
      
      例: filedownload.php 
      
        
        
        
      
    
      
        
        
        
      
      &chkDesc 
      
        
        
        
      
      デフォルト: null 
      
        
        
        
      
      値:チャンク名 
      
        
        
        
      
      説明:このオプションを使用すると、ファイルに説明を追加できます。 パラメーターは、説明とともにチャンクの名前を指定します。 チャンク内のレコードの構文は次のとおりです。directory / file_name |ファイルの説明|| 
      
        
        
        
      
    
      
        
        
        
      
      例: 
      
        
        
        
      
     チャンク名:fileDescription 
      
        
        
        
      
     チャンクコンテンツ: 
      
        
        
        
      
     アセット/スニペット/ filedownload / test.pdf |これはテストpdfです。 レポートの内容を表示します。 
      
        
        
        
      
     アセット/スニペット/ filedownload / options.gif |これらは利用可能なオプションです|| 
      
        
        
        
      
    
      
        
        
        
      
     それだけです。これらのパラメーターは、スニペットの使用を開始するのに十分です。 ヘルプファイルのその他のパラメーターは、アーカイブ(英語)、 
ここ、またはFileDownloadモジュールを使用したアーカイブで確認できます。これについては、以下で説明します。 
      
        
        
        
      
    
      
        
        
        
      
     そのため、スニペットに精通している場合、または今すぐ試してみた場合、ファイルの説明を編集するのは非常に不便であることに気づくでしょう。特に、専任でない人(秘書など) 結局のところ、チャンクは次のようになります。 
      
        
        
        
      
     
      
        
        
        
      
    
      
        
        
        
      
     さて、単純なニーズのために、FileDownload Moduleと呼ばれる単純なモジュールを追加することで、このことを変更できます。 
      
        
        
        
      
    
      
        
        
        
      
     ファイルダウンロードモジュール 
  -これは、ファイルの説明をより便利に追加および編集するために作成されたアドオンです。 
      
        
        
        
      
    
      
        
        
        
      
      インストール: 
      
        
        
        
      
      •ファイルアーカイブ記述エディターなどの名前で新しいモジュールを作成します。 
      
        
        
        
      
      •FileDownloadモジュールv0.9b.phpファイルの内容をモジュールコードウィンドウにコピーします。 コードの先頭と末尾の<?Phpタグを忘れずに削除してください。 
      
        
        
        
      
      •コード自体で必要なパラメーターを変更して、モジュールを構成します。 
      
        
        
        
      
    
      
        
        
        
      
      パラメータ: 
      
        
        
        
      
      $ downloadFolder = 'コンマで区切られたディレクトリ名';  -モジュールによってスキャンされるディレクトリのリスト。 呼び出し時に使用するすべてのディレクトリまたはさまざまなスニペット呼び出しをリストします。 
      
        
        
        
      
      $ chunkname = 'チャンク名';  -説明が保存されている、または保存されるチャンクの名前。 
      
        
        
        
      
      $ chunkid = 'id chunk';  -説明が保存されている、または保存されるチャンクのID。  Element Management-> ChunksでチャンクのIDを確認できます。 括弧で、チャンクの名前の横に、IDが示されます。 
      
        
        
        
      
    
      
        
        
        
      
      それはどのように見えますか: 
      
        
        
        
      
    
      
        
        
        
      
     モジュールマネージャーに新しいアイテムがあります。 
      
        
        
        
      
     
      
        
        
        
      
    
      
        
        
        
      
     モジュールパネルからクリックすると、次のようなシンプルなインターフェースが表示されます。 
      
        
        
        
      
     
      
        
        
        
      
    
      
        
        
        
      
     これで、ファイルの説明を変更するためのシステムについて説明したときに、自分で、または秘書を通じてすべてを行うことを好む顧客は目を丸くすることはありません。 
      
        
        
        
      
    
      
        
        
        
      
      したがって、ダウンロードするファイル: 
      
        
        
        
      
    
      
        
        
        
      
      モジュールとドキュメント 
      
        
        
        
      
      モジュール、ドキュメント、スニペット自体(すべて1つ) 
      
        
        
        
      
    
      
        
        
        
      
     ちなみに、「オールインワン」アーカイブにはボーナスがあります-さまざまなファイル拡張子のアイコンが、元のアーカイブにはなかった理由です。 
      
        
        
        
      
    
      
        
        
        
      
     記事、スニペットドキュメントの翻訳、およびモジュールが誰かに役立つことを願っています)