Installation

- Allez dans le menu Extensions > Gestionnaire d'extensions et installez le plugin.
- Accédez à Extensions > Gestionnaire de plugins et activez le plugin nommé Virtuemart 2 | téléchargement du produit


Créer un champ personnalisé

- Accédez à Composants > VirtueMart
- Sélectionnez le menu Produits > Champs personnalisés
- Cliquez sur le bouton Nouveau
- Sélectionnez « Type de champ personnalisé » : Modules d'extension
- Saisissez un titre
- Sélectionnez pour le champ Attribut du panier Oui
- Dans le champ « Sélectionnez un plug-in », choisissez Virtuemart 2 | téléchargement du produit
- Cliquez sur Enregistrer


Configurez votre chemin de sécurité

Les fichiers à vendre sont stockés dans le dossier Safe Path indiqué dans la configuration de VirtueMart.

- Sélectionnez le menu Configuration > Configuration
- Sélectionnez l' Modèles onglet
- Le paramètre « Chemin sécurisé » correspond au dossier contenant les fichiers à vendre.
  Il doit s'agir d'un chemin situé en dehors de votre répertoire web.


Téléchargez vos fichiers à vendre

- Dans l'administration de VirtueMart, choisissez le menu Boutique > Fichiers multimédias .
- Cliquez sur le bouton Nouveau pour créer un nouveau média.
- Définissez le rôle sur « À vendre ».
- Définissez l’« Action sur l’image » sur « Télécharger » et appuyez sur Enregistrer/Stocker.

Si vos fichiers sont trop volumineux pour un envoi HTTP, utilisez votre client FTP.
Transférez-les dans un répertoire sécurisé. Ensuite, utilisez le bouton « Synchroniser les médias » dans votre interface multimédia.
Joignez vos médias à votre produit.


Joignez vos médias à votre produit

- Sélectionnez le menu Produits > Produits
- Cliquez sur le produit pour lequel vous souhaitez ajouter un fichier à la vente.
- Sélectionnez l'onglet Champs personnalisés.
- Dans la zone Type de champ personnalisé , sélectionnez le champ personnalisé que vous avez créé pour joindre un fichier téléchargeable.
- Dans la zone de téléchargement, sélectionnez le fichier que vous souhaitez joindre à votre produit.
- Cochez la case « Fournir en flux » si vous souhaitez proposer le téléchargement en flux continu.
- Si vous fournissez le téléchargement sous forme de flux, modifiez le paramètre du champ « Vitesse maximale en ko ».
- Cliquez sur Enregistrer et fermer.

Lorsque vos clients doivent pouvoir télécharger des fichiers que vous associez ultérieurement à votre produit, il est crucial de ne jamais supprimer votre configuration personnalisée et de conserver l'intégralité du champ personnalisé de votre premier produit.
Modifiez les fichiers utilisés, mais ne les supprimez surtout pas, sinon les clients ayant déjà effectué des achats ne pourront plus accéder au téléchargement.

Pour remplacer un fichier existant, nous recommandons d'effectuer une action de remplacement dans vmbe > shop > mediafiles.


Configuration des limites, des restrictions et des délais


- Le nombre maximal de téléchargements désigne l'ensemble des téléchargements.
- Le nombre maximal de téléchargements par intervalle (en jours) indique la fréquence à laquelle les utilisateurs sont autorisés à télécharger votre produit lorsque vous définissez un intervalle de temps.
- L'intervalle en jours correspond à la durée en jours de l'intervalle.
- Le nombre maximal de jours de téléchargement après le premier téléchargement correspond à la durée pendant laquelle une personne est autorisée à télécharger le fichier.
- Vous pouvez définir une date de début et/ou une date de fin pour une période donnée.

Important : Toutes les conditions sont cumulatives.

Dans l’exemple ci-dessus, un utilisateur est autorisé à télécharger le fichier pendant un an, mais au maximum deux fois en dix jours.
Cela représente un maximum de 70 téléchargements, limités par la limite de 50.
La période saisie déterminera si un utilisateur est autorisé à télécharger le fichier.


Testez votre plugin téléchargeable

Sur l'interface principale, sélectionnez votre produit et procédez au paiement.



Je ne peux pas finaliser ma commande dans mon panier, le message suivant s'affiche : « Nous sommes désolés, aucun mode d'expédition ne correspond aux caractéristiques de votre commande. »

- Créez au moins une méthode d'expédition nommée par exemple « Téléchargement ».



Je vends des produits virtuels et physiques.
Que dois-je faire ?

- Pour tous vos produits virtuels, définissez le poids à 0.
- Pour les autres produits, définissez le poids à une valeur différente de 0.


Créez au moins deux modes d'expédition :

- Une livraison gratuite si le poids est nul. Cette option sera sélectionnée si l'acheteur n'achète que des produits virtuels.
- Une ou plusieurs autres méthodes d'expédition seront proposées pour les colis d'un poids différent de 0. Ces méthodes d'expédition seront sélectionnées lorsque le panier contient des produits non virtuels.

Une fois la commande confirmée , votre client recevra un reçu contenant un lien de téléchargement.
Il pourra également télécharger le fichier depuis son compte en utilisant son numéro de commande et son mot de passe.


Le téléchargement est créé à l'aide de techniques de streaming. Veuillez noter que l'option de streaming n'empêche pas l'utilisation de la fonction « Enregistrer la cible sous… ».

Important : le téléchargement est activé lorsque le statut de la commande est confirmé/expédié. Le téléchargement du fichier modifie le statut de l’article de la commande en « expédié ».



Je veux proposer des téléchargements gratuits

Modifiez vos modes de paiement configurés et ajoutez, si ce n'est pas déjà fait, une valeur minimale de 0,01.
Créez ensuite un autre mode de paiement par défaut (mode : standard ) et définissez le maximum à 0,001 ainsi que le « Statut des commandes en attente » sur « Confirmé par l'acheteur ».
Vos clients recevront alors un e-mail contenant le lien.


Je souhaite réactiver un téléchargement

Vous pouvez le faire avec la version 2.0.20, mais le noyau nécessite une petite modification (elle sera intégrée au noyau dans la prochaine version).
Il suffit de rechercher administrator\components\com_virtuemart\controllers\plugin.php, d'aller à la ligne 49 et de remplacer le mot getWord par getString.
La ligne 49 devrait alors ressembler à ceci : $name = JRequest::getString('name','');

Une autre variante pour réactiver le téléchargement : consultez la commande (VM > Commandes) et cliquez sur le symbole vert pour réinitialiser le compteur de téléchargement.


Je ne trouve pas mes médias dans le menu déroulant du plugin

Vous n'avez pas téléchargé votre fichier multimédia en tant que « fichier à vendre ».


Je reçois un fichier dont la taille est trop petite (1-2 ko).

Renommez le fichier en ajoutant l'extension .html, puis ouvrez-le dans un navigateur.
Vous y verrez le message d'erreur. Il est fort probable que le chemin d'accès sécurisé soit incorrect.
Vérifiez que votre chemin d'accès sécurisé se termine bien par une barre oblique (ou une barre oblique inverse sous Windows).


Comment définir le chemin de sécurité correct ?


Le chemin sécurisé doit se situer en dehors de votre répertoire public_html.
Si aucun chemin n'est spécifié, un message s'affiche indiquant le répertoire parent de votre chemin Joomla absolu, auquel est ajouté « vmfiles ».
Ceci n'est qu'une suggestion. Vous pouvez également définir le chemin sécurisé dans votre répertoire Joomla, mais vous devez alors utiliser un nom difficile à deviner, comme « knzius » (un peu comme un mot de passe).
Pour plus d'informations, consultez le forum : http://forum.virtuemart.net/index.php?topic=98633.msg325409#msg325409


Le lien de téléchargement n'apparaît pas dans l'e-mail envoyé au client.

Le lien de téléchargement doit figurer dans l'e-mail envoyé au client, où le produit est référencé. De plus, votre client peut trouver ce lien en consultant sa commande en ligne.

Si le lien n'apparaît pas dans l'e-mail et/ou la commande, cela se produit presque toujours en raison d'une surcharge du modèle de l'e-mail ou de la mise en page des détails du produit.
Parfois, les utilisateurs indiquent que le lien est présent de façon aléatoire ; dans ce cas, le modèle utilisé ne propose pas les boutons « Ajouter au panier » appropriés dans la vue catégorie.


J'obtiens une page blanche lorsque je clique sur le lien de téléchargement
.

Cela peut être dû à une bande passante insuffisante qui réduit l'utilisation de la RAM de votre serveur.
Veuillez réessayer avec une valeur plus faible dans le champ « Vitesse maximale en ko » (1024 = 1 Mo de RAM PHP) de la vue des champs personnalisés de votre produit.


J'ai migré de VM2 à VM3 et, lors du téléchargement du plugin, j'obtiens maintenant le message d'erreur suivant : 1054 - Colonne inconnue « virtuemart_product_id » dans la liste des champs. SQL=INSERT INTO `'#_virtuemart_product_custom_plg_st42_download` (`id`, ...
Que dois-je faire ?

Dans VMBE, accédez aux champs personnalisés et enregistrez le prototype du champ personnalisé ; la colonne est alors ajoutée.


Le lien de téléchargement est absent du courriel envoyé au fournisseur ; est-il manquant ?

Actuellement, le lien de téléchargement apparaît uniquement dans l'e-mail destiné au client. En tant qu'administrateur, vous pouvez y accéder via la page des détails de la commande.


Après la mise à jour vers la version 2.8.8, mes téléchargements ne fonctionnent plus.

Une nouvelle fonctionnalité permet de sélectionner le statut de la commande pour la distribution du téléchargement.
Il arrive que le système de retour automatique vers le client ne fonctionne pas.
Ouvrez votre prototype de champ personnalisé (/administrator/index.php?option=com_virtuemart&view=custom) et définissez-y le statut de la commande ; tout devrait alors fonctionner à nouveau.