This is an old revision of the document!


Installation

PvDL is a complete solution to manage all of your software download files.

All you need to do is upload your files in the appropriate download folder following our naming convention. PvDL will automatically build all of your download links ready for your customers to download the latest versions of your software. Users will be able to browse files, check ChangeLogs, access private or public betas, view all versions available and much more… A huge time saver !

Requirements

  • Any decent web server
  • php version 5

INSTALL manually

  • 1) Copy the whole _pvdl_ folder at the root of your web server. Example :
    • If your webserver's root is located at : /home/user/public_html
    • The pvdl folder should be located at : /home/user/public_html/pvdl
  • 2) In the _pvdl_ folder, rename the “my-default” folder to “my”.
  • 3) Create a “downloads” directory at the root of your web server.
    • Example : /home/user/public_html/downloads
  • 4) Edit the configuration file _my/pvdl_conf.php_ and for now, simply change the _REQUIRED_ parameters.

(or INSTALL using Git)

  • 1) You must have an account on our private Git server!
    • If you do not have one, please read the [Development doc](?doc=5_Development.md).
  • 2) Using terminal : Type the following commands :
      cd WEB_ROOT_DIRECTORY
      git clone -b master git@git.plugivery.com:pv-apis/pvdl.git
      mv pvdl/my-default pvdl/my
      mkdir pvdl_downloads pvdl_downloads/release pvdl_downloads/beta_public pvdl_downloads/beta_private
  • 3) Go to step 4 in the “INSTALL manually” chapter just above

Notes

Your web server must be configured to accept index.php as the default page ! If not already configured on your Apache web server, you should add/modify the directive bellow, either in your Apache configuration or in a .htaccess file located in the pdvl directory (or in the web root directory).

    DirectoryIndex index.php

Learn more at : http://www.cyberciti.biz/faq/apache-display-or-change-a-default-page-other-than-indexhtml/

For your convenience, we have included an (invisible) .htaccess file in the _pvdl_ directory that does this for you. Therefore if you copied the whole pvdl folder (including the invisible files), it should work as expected. If you nevertheless encounter a 500 or 401 error, it means that Apache is configured to prevent using local .htaccess files. In this case, simply remove the .htaccess file from the pvdl folder.

PvDL Files

Stucture of the PvDL directory :

  • /cache/ may be used to store some cached objects. If you use it, you should set its permissions to “rwxrwxrwx” ( chmod 777 pvdl/cache/ )
  • /doc/ contains this documentation (and can be safely removed if needed)
  • /lib/ contains the main classes
  • /my/ contains your OWN configuration (it will not be replaced by a Git update)
  • /static/ contains the css, javascript, fonts and image medias
  • index.php is the main php script
  • .htaccess sets the Apache Configuration
  • .gitignore is used by Git to ignore some files (applies only to Git installation)