OnTouch

Pré requis

Avez-vous bien suivi les Aspects Généraux avant de continuer ?

Introduction

Cet objet de 2 prims (1 est optionnelle, utilisée pour le texte flottant et la gestion des listes rouges personnelles, et peut être enlevée, si nécessaire) permet à vos clients où connaissances de devenir facilement membre de votre groupe, en cliquant simplement un panneau. Ils obtiendront alors la fenêtre d'invitation classique de SL sur leur écran!

Démarrage Rapide

Si vous souhaitez rapidement mettre en place un OnTouch, suivez la procédure suivante: Rezzez un OnTouch depuis votre inventaire. Vous obtiendrez un objet similaire à celui affiché sur la droite de ce paragraphe. Touchez la prim centrale, affichant la texture "OffLine". Vous obtiendrez alors un menu Dans le menu, choisissez l'option "Groupe..." L'objet va vous demander d'entrer le nom exact du groupe souhaité directement dans le chat. Faites le, et presser entrée à la fin. Veuillez à épeler le nom correctement Vous verrez alors la machine essayer de valider le nom que vous avez entré Si le nom entré était correct, vous obtiendrez un message indiquant un succès, et la prim centrale va afficher la texture de votre groupe ! Si le nom était incorrect, veuillez entrer à nouveau dans le menu pour choisir le nom Et voilà ! Toute personne cliquant la prim centrale aura une invitation ! Vous pouvez également tester l'objet en choisissant "Utilisateur" dans le menu

Manuel d'utilisation

L'objet OnTouch réagit uniquement au toucher. Les avatars peuvent toucher ses 2 prims.

Si un avatar touche la prim centrale, l'objet OnTouch va avoir 3 différents comportements, dépendant de la catégorie à laquelle appartient l'avatar:

• Pour le propriétaire de l'objet: le OnTouch va faire apparaître un menu complet
• Pour les "utilisateurs de confiance": le OnTouch va afficher un menu partiel. Les "utilisateurs de confiance" sont les personnes en qui le propriétaire de la prim à confiance, suffisamment pour leur accorder un certain contrôle sur un invitor. Tout avatar peut être promu "utilisateur de confiance" en ajoutant simplement une notecard dans le contenu de l'invitor, ayant le nom de la personne de confiance. Le contenu de la notecard lui-même peut être vide.
• Pour toute autre personne: le OnTouch va déclencher le processus d'invitation

Toucher l'autre prim (celle du bas) va déclencher un menu permettant à tout un chacun de contrôler son appartenance à la liste rouge utilisateur pour le groupe configuré.

Le menu obtenu par le propriétaire sera organisé de cette façon:

Cliquez sur un bouton pour voir les explications: Compte: affiche un sous-menu: Etat: vous donne l'information sur vos crédits restants Prix: vous donne les informations de prix de ce service Payer: vous fait entrer en mode paiement, afin de rajouter des crédits à votre compte. Vous devrez certainement accepter d'accorder la permission de débit au préalable, puis payer la prim. Groupe: vous permet de configurer le groupe à utiliser. Voir les Trucs & Astuces pour plus d'information Liste Rouge: vous donne un sous-menu: Liste: vous donne l'état de vos listes rouges. Toutes les listes seront affichées (Propriétaire, Personnelle, ...) Proprio +: vous permet d'ajouter un avatar à la liste rouge du propriétaire (SEULEMENT si vous avez les droits d'éjection dans le groupe) Proprio -: vous permet d'enlever un avatar de la liste rouge du propriétaire (SEULEMENT si vous avez les droits d'éjection dans le groupe) Bannir +: ajoute un avatar à la liste des avatars bannis. cette option ne fonctionne que si vous utilisez le service Group.Invitor.Fixed Bannir -: enlève un avatar de la liste des avatars bannis. cette option ne fonctionne que si vous utilisez le service Group.Invitor.Fixed Config: vous donne un sous-menu: Texte: fournit des instructions pour changer le texte flottant Image auto: (config par défaut) ce mode vous permet d'afficher automatiquement la texture liée à un groupe une fois celui-ci sélectionné Image manuelle: désactive le mode automatique ci-dessus Vous aurez d'autres choix dans ce menu, vous permettant de choisir la langue utilisée par cet objet. Les options présentées dépendent des scripts disponibles dans votre invitor. Les scripts correspondant aux langues non utilisées sont désactivés, afin de consommer moins de ressources. Stats: vous donne un sous-menu: Cette machine: donne des informations pour cette machine, depuis qu'elle a été rezzée, ou depuis le dernier changement de groupe Stats Web: vous donne un lien pour le web, pour les statistiques complètes Utilisateur: tente une invitation du propriétaire de la prim (comme s'il était utilisateur normal). Voir les Trucs & Astuces pour plus d'informations

Un utilisateur de confiance verra partiellement ce menu. Les choix Compte et Groupe lui seront inaccessibles.

Haut de page

OnDetect

Pré requis

Avez-vous bien suivi les Aspects Généraux avant de continuer ?

Avez-vous déjà essayé de rezzer et configurer un OnTouch avant de continuer ?

Introduction

A la différence du OnTouch, le OnDetect invite les avatars de manière automatique. Cette invitation survient lorsque l'avatar passe au travers de la seule prim invisible de l'objet OnDetect.

Cet objet est particulièrement adapté aux situations où vous avez une entrée principale à votre magasin, ou bien un point de téléport sur votre parcelle: rezzer un invitor à cet endroit, adaptez sa forme à vos besoins (pas trop mince, pour que la détection puisse avoir lieu avec un avatar avançant à une vitesse normal) et les avatars seront invités à leur arrivée !

Par ailleurs, comme cet objet invite de manière autonome, un système de sécurité AntiSpam est présent: un avatar qui vient de recevoir une invitation n'en recevra plus de nouvelle, jusqu'à ce qu'un certain délai réglable se soit écoulé.
Ce système évite d'inviter la même personne plusieurs fois de suite.

Démarrage Rapide

Si vous souhaitez rapidement mettre en place un OnDetect, suivez la procédure suivante: Rezzez un OnDetect depuis votre inventaire. Vous obtiendrez un objet similaire à celui affiché sur la droite de ce paragraphe (la prim blanche fantôme) Adaptez-le à la taille et position voulues Touchez le. Vous obtiendrez alors un menu Dans le menu, choisissez l'option "Groupe..." L'objet va vous demander d'entrer le nom exact du groupe souhaité directement dans le chat. Faites le, et presser entrée à la fin. Veuillez à épeler le nom correctement Vous verrez alors la machine essayer de valider le nom que vous avez entré Si le nom entré était correct, vous obtiendrez un message indiquant un succès ! Si le nom était incorrect, veuillez entrer à nouveau dans le menu pour choisir le nom Touchez le OnDetect de nouveau, et choisissez "En ligne" dans le menu Et voilà ! La prim va disparaître, mais elle est toujours là ! Tout avatar la pénétrant aura une invitation après un court délai ! Note: pour afficher les prims invisibles, utilisez l'astuce de SL: pressez CTRL + ALT + T. Pressez de nouveau pour revenir à la normale

Manuel d'utilisation

L'objet OnDetect réagit uniquement au toucher.

Si un avatar touche la prim, l'objet OnDetect va avoir 3 différents comportements, dépendant de la catégorie à laquelle appartient l'avatar:

• Pour le propriétaire de l'objet: le OnDetect va faire apparaître un menu complet
• Pour les "utilisateurs de confiance": le OnDetect va afficher un menu partiel. Les "utilisateurs de confiance" sont les personnes en qui le propriétaire de la prim à confiance, suffisamment pour leur accorder un certain contrôle sur un invitor. Tout avatar peut être promu "utilisateur de confiance" en ajoutant simplement une notecard dans le contenu de l'invitor, ayant le nom de la personne de confiance. Le contenu de la notecard lui-même peut être vide.
• Pour toute autre personne: il ne se passera rien

Le menu obtenu par le propriétaire sera organisé de cette façon:

Cliquez sur un bouton pour voir les explications: Compte: affiche un sous-menu: Etat: vous donne l'information sur vos crédits restants Prix: vous donne les informations de prix de ce service Payer: vous fait entrer en mode paiement, afin de rajouter des crédits à votre compte. Vous devrez certainement accepter d'accorder la permission de débit au préalable, puis payer la prim. Groupe: vous permet de configurer le groupe à utiliser. Voir les Trucs & Astuces pour plus d'information Liste Rouge: vous donne un sous-menu: Liste: vous donne l'état de vos listes rouges. Toutes les listes seront affichées (Propriétaire, Personnelle, ...) Proprio +: vous permet d'ajouter un avatar à la liste rouge du propriétaire (SEULEMENT si vous avez les droits d'éjection dans le groupe) Proprio -: vous permet d'enlever un avatar de la liste rouge du propriétaire (SEULEMENT si vous avez les droits d'éjection dans le groupe) Bannir +: ajoute un avatar à la liste des avatars bannis. cette option ne fonctionne que si vous utilisez le service Group.Invitor.Fixed Bannir -: enlève un avatar de la liste des avatars bannis. cette option ne fonctionne que si vous utilisez le service Group.Invitor.Fixed Config: vous donne un sous-menu: Antispam: vous permet de sélectionner la durée pour l'antispam, de 1 à 30 jours. Valeur par défaut: 3 jours Filtre Langage: vous permet de n'inviter que les personnes dont le viewer est réglé sur une certaine langue. Valeur par défaut: aucun filtre Filtre Age: vous permet de ne PAS inviter les personnes plus âgées qu'un certain âge. Valeur par défaut: aucun filtre Silence/Bavard: désactive/active l'affichage de messages lors des invitations. Valeur par défaut: Bavard Vous aurez d'autres choix dans ce menu, vous permettant de choisir la langue utilisée par cet objet. Les options présentées dépendent des scripts disponibles dans votre invitor. Les scripts correspondant aux langues non utilisées sont désactivés, afin de consommer moins de ressources. Stats: vous donne un sous-menu: Cette machine: donne des informations pour cette machine, depuis qu'elle a été rezzée, ou depuis le dernier changement de groupe Stats Web: vous donne un lien pour le web, pour les statistiques complètes Hors Ligne/En Ligne: désactive ou active la machine

Un utilisateur de confiance verra partiellement ce menu. Les choix Compte et Groupe lui seront inaccessibles.

Note: si trop d'avatars sont détectés au même moment, le OnDetect invitera seulement certains d'entre eux, afin de conserver suffisamment de ressources et ne pas générer de lag.

Haut de page

OnSensor

Pré requis

Avez-vous bien suivi les Aspects Généraux avant de continuer ?

Avez-vous déjà essayé de rezzer et configurer un OnTouch avant de continuer ?

Introduction

A la différence du OnTouch, le OnSensor invite les avatars de manière automatique. Cette invitation survient lorsque l'avatar entre a l'intérieur d'un certain périmètre autour du OnSensor.

Cet objet est particulièrement adapté aux situations où vous n'avez pas d'entrée principale à votre magasin, ou bien aucun point de téléport sur votre parcelle: rezzer un OnSensor où vous le désirez, configurez-le, et les avatars seront invités à l'approche du OnSensor !

Par ailleurs, comme cet objet invite de manière autonome, un système de sécurité AntiSpam est présent: un avatar qui vient de recevoir une invitation n'en recevra plus de nouvelle, jusqu'à ce qu'un certain délai réglable se soit écoulé.
Ce système évite d'inviter la même personne plusieurs fois de suite.

Démarrage rapide

Si vous souhaitez rapidement mettre en place un OnSensor, suivez la procédure suivante: Rezzez un OnSensor depuis votre inventaire. Vous obtiendrez un objet similaire à celui affiché sur la droite de ce paragraphe Touchez le. Vous obtiendrez alors un menu Dans le menu, choisissez l'option "Groupe..." L'objet va vous demander d'entrer le nom exact du groupe souhaité directement dans le chat. Faites le, et presser entrée à la fin. Veuillez à épeler le nom correctement Vous verrez alors la machine essayer de valider le nom que vous avez entré Si le nom entré était correct, vous obtiendrez un message indiquant un succès ! Si le nom était incorrect, veuillez entrer à nouveau dans le menu pour choisir le nom Touchez le OnSensor de nouveau, et choisissez "En ligne" dans le menu Et voilà ! Le bord du OnSensor va devenir vert, signifiant qu'il est actif: tout avatar entrant dans un périmètre de 30 mètres (réglage par défaut) du OnSensor sera invité après un court délai !

Manuel d'utilisation

L'objet OnSensor réagit uniquement au toucher.

Si un avatar touche la prim, l'objet OnSensor va avoir 3 différents comportements, dépendant de la catégorie à laquelle appartient l'avatar:

• Pour le propriétaire de l'objet: le OnSensor va faire apparaître un menu complet
• Pour les "utilisateurs de confiance": le OnSensor va afficher un menu partiel. Les "utilisateurs de confiance" sont les personnes en qui le propriétaire de la prim à confiance, suffisamment pour leur accorder un certain contrôle sur un invitor. Tout avatar peut être promu "utilisateur de confiance" en ajoutant simplement une notecard dans le contenu de l'invitor, ayant le nom de la personne de confiance. Le contenu de la notecard lui-même peut être vide.
• Pour toute autre personne: il ne se passera rien

Le menu obtenu par le propriétaire sera organisé de cette façon:

Cliquez sur un bouton pour voir les explications: Compte: affiche un sous-menu: Etat: vous donne l'information sur vos crédits restants Prix: vous donne les informations de prix de ce service Payer: vous fait entrer en mode paiement, afin de rajouter des crédits à votre compte. Vous devrez certainement accepter d'accorder la permission de débit au préalable, puis payer la prim. Groupe: vous permet de configurer le groupe à utiliser. Voir les Trucs & Astuces pour plus d'information Liste Rouge: vous donne un sous-menu: Liste: vous donne l'état de vos listes rouges. Toutes les listes seront affichées (Propriétaire, Personnelle, ...) Proprio +: vous permet d'ajouter un avatar à la liste rouge du propriétaire (SEULEMENT si vous avez les droits d'éjection dans le groupe) Proprio -: vous permet d'enlever un avatar de la liste rouge du propriétaire (SEULEMENT si vous avez les droits d'éjection dans le groupe) Bannir +: ajoute un avatar à la liste des avatars bannis. cette option ne fonctionne que si vous utilisez le service Group.Invitor.Fixed Bannir -: enlève un avatar de la liste des avatars bannis. cette option ne fonctionne que si vous utilisez le service Group.Invitor.Fixed Config: vous donne un sous-menu: Distance: vous permet de régler la distance maximale de détection, de 10m à 90m. Valeur par défaut: 30m Antispam: vous permet de sélectionner la durée pour l'antispam, de 1 à 30 jours. Valeur par défaut: 3 jours Filtre Langage: vous permet de n'inviter que les personnes dont le viewer est réglé sur une certaine langue. Valeur par défaut: aucun filtre Filtre Age: vous permet de ne PAS inviter les personnes plus âgées qu'un certain âge. Valeur par défaut: aucun filtre Silence/Bavard: désactive/active l'affichage de messages lors des invitations. Valeur par défaut: Bavard Vous aurez d'autres choix dans ce menu, vous permettant de choisir la langue utilisée par cet objet. Les options présentées dépendent des scripts disponibles dans votre invitor. Les scripts correspondant aux langues non utilisées sont désactivés, afin de consommer moins de ressources. Stats: vous donne un sous-menu: Cette machine: donne des informations pour cette machine, depuis qu'elle a été rezzée, ou depuis le dernier changement de groupe Stats Web: vous donne un lien pour le web, pour les statistiques complètes Hors Ligne/En Ligne: désactive ou active la machine

Un utilisateur de confiance verra partiellement ce menu. Les choix Compte et Groupe lui seront inaccessibles.

Note1: si trop d'avatars sont détectés au même moment, le OnSensor invitera seulement certains d'entre eux, afin de conserver suffisamment de ressources et ne pas générer de lag.

Note2: Le OnSensor utilise la fonction LSL llSensor, et hérite donc de ses limitations: jusqu'à 16 avatars seulement peuvent être détectés. L'opération de détection est réalisée toutes les 20 secondes (en dehors de toute requête en cours)

Note3: Afin d'éviter le spam de vos voisins, le OnSensor invitera uniquement les avatars entrant dans la zone de détection et se trouvant sur une parcelle dont le propriétaire est le même que celui de la parcelle où se trouve le OnSensor

Haut de page

Plugin (Extension) pour XStreetSL

Pré requis

Avez-vous bien suivi les Aspects Généraux avant de continuer ?

Avez-vous déjà essayé de rezzer et configurer un OnTouch avant de continuer ?

Introduction

XStreetSL est la plateforme de vente de biens virtuels de Linden Labs.

Une intégration avec le service Group.Invitor est intéressante, pour inviter les personnes qui viennent d'acheter un article sur XStreetSL !

Techniquement, il y a 2 moyens de s'intégrer avec XStreetSL.

MyRoBoT a choisi le plus simple d'entre eux pour l'utilisateur, grâce au Système de Notification Automatique de XStreetSL (ANS) (Vous pourriez avoir à vous connecter et à cliquer de nouveau ce lien)

En une seule prim, vous pouvez décider quelles invitations effectuer en fonction du produit vendu sur XStreetSL depuis n'importe quelle Magic Box sur SL !

Démarrage Rapide

Si vous souhaitez rapidement mettre en place une intégration avec XStreetSL,suivez la procédure suivante:

• Rezzer une Magic Box XStreetSL AVEC ANS. Vous pouvez en acheter une pour 0 L$ à cet endroit
• Copier les fichiers suivants dans votre nouvelle Magic Box:
  • Group.Invitor.ANS.XStreetSL 1.5
  • Group.Invitor.Config 1.5
  • SimpleServiceBot-GroupInvitor 1.5
  • Choisissez un des scripts StringsAndLoader.XX, où XX correspond à la langue de votre choix: fr pour français, de pour allemand, en pour anglais, es pour espagnol
• Allez sur le site web de XStreetSL, dans les préférences (Vous pourriez avoir à vous connecter et à cliquer de nouveau ce lien)
• Activer l'ANS, et choisissez l'option "Objet Second Life", avec la Magic Box que vous venez de rezzer
• Décider si vous souhaiter une vérification ou non, en cochant la case correspondante ou non
• Mettez à jour la configuration
• De retour dans Second Life, ouvrez la notecard que vous avez mis dans la nouvelle prim, nommée Group.Invitor.Config 1.5
• La 1ère ligne commençant par LANG= est la langue choisie. Entrez ici la langue que vous avez choisie en choisissant le fichier StringsAndLoader.XX. Par exemple, si vous avez choisi le français, vous devriez entrer:
  
  
  LANG=fr
  
  
• A côté de la chaine CHECK=, mettez YES si vous avez coché la case de vérification sur XStreetSL, sinon mettez NO
  
  
  CHECK=YES
  
  
• Remplacez la dernière ligne de la notecard par son équivalent avec votre groupe. Par exemple, si votre groupe était MyRoBoT, cette ligne devrait être:
  
  
  FILTER=ELSE-->MyRoBoT
  
  
• Enregistrer la notecard. Vous verrez que la machine vérifie sa syntaxe.
• Si la vérification est un succès, vous avez terminé ! La machine invitera les personnes lors d'un achat au groupe que vous avez indiqué (à condition qu'il n'y ait pas de condition de spam ou de filtrage) !

Manuel d'utilisation

Suivez la procédure de démarrage rapide ci-dessus. Ensuite vous pouvez régler les détails avec toutes les options disponibles.

La notecard respecte les règles suivantes:

• La notecard est basée sur une collection de paires clé=valeur, une paire par ligne.
• Les lignes vides, ou commençant par // sont considérées comme des commentaires, et non prises en compte.
• Il peut y avoir un maximum de 20 lignes (commentaires inclus)

Les clés disponibles pour XStreetSL sont:

• LANG: les valeurs réglables sont actuellement fr, en, de et es, pour français, anglais, allemand, et espagnol. Vous DEVEZ indiquer la même langue que celle utilisée avec le script StringsAndLoader.XX choisi. Sinon le chargement de la notecard échouera. La valeur par défaut est en
• AGEFILTER: la valeur acceptée est une quantité, avec un signe < ou > juste avant. Par exemple, >12 signifie de ne PAS inviter les avatars plus vieux que 12 mois de SL. Vous pouvez aussi utiliser <, pour ne PAS inviter les avatars plus jeunes qu'un âge donné. La valeur par défaut est >36
• CHECK: la valeur est soit YES, soit NO, et doit être la même que celle indiquée avec la case à cocher de vérification sur le site web XStreetSL dans votre partie ANS. La valeur par défaut est NO
• VERBOSE: la valeur est soit YES, soit NO. YES signifie que les scripts afficheront des commentaires sur chaque invitation. La valeur par défaut est YES.
  • La valeur EXTRA est aussi acceptée, et signifie qu'en plus des commentaires du choix YES, les scripts afficheront les notifications reçues depuis le service
• ANTISPAM: la valeur acceptée est un nombre, entre 86400 et 2592000. Il s'agit d'une durée, exprimée en secondes, et signifie que vous pouvez régler la durée pour l'antispam entre 1 jour et 30 jours. La valeur par défaut est de 30 jours.
• FILTER: il doit y avoir au moins une ligne démarrant par FILTER, et il peut y en avoir plusieurs. Chaque ligne sera prise en compte, l'une après l'autre, dans l'ordre où elles apparaissent.. Chaque ligne doit être formatée de la même manière:
  
  
  FILTER=Clé-->Valeur-->Nom du groupe|||Role
  
  
  • où Clé est la clé envoyée par les services XStreetSL, grâce à l'ANS.
  • où Valeur est la valeur à vérifier
  • où |||Role est optionnel, et fonctionne uniquement avec le service Group.Invitor.Fixed service
  
  Les clés envoyées par le système de notification ANS de XStreetSL sont:
  
  
  • Type: toujours 'Purchase'
  • Currency: SLL ou USD
  • TransactionID: nombre
  • ItemID: nombre
  • ItemName: nom de l'article vendu
  • InventoryName: nom de l'objet qui a été livré lors de la vente
  • PaymentGross: coût global de la vente, commission incluse
  • PaymentFee: coût de la commission
  • PayerKey: clé UUID de l'avatar qui a payé
  • PayerName: nom de l'avatar qui a payé
  • MerchantKey: clé UUID du marchand
  • MerchantName: nom de l'avatar qui est le marchand
  • ReceiverKey: clé UUID de l'avatar qui a reçu l'article
  • ReceiverName: nom de l'avatar qui a reçu l'article
  
  

  Les scripts vont comparer la valeur inscrite dans la notecard avec celle envoyée par ANS. Cela donne une grande flexibilité quant à vos choix !

  Important:  XStreetSL ANS envoie souvent des champs vides.. Testez donc de manière intensive  !
  
  Voici quelques exemples de lignes FILTER:

  FILTER=PaymentGross-->0-->Freebies Owners // Invitation de tout avatar achetant un de vos freebies dans le groupe Freebies Owners
  FILTER=ProductName-->Poofer1-->Miss Gadgets items addicts ! // Invitation de tout avatar achetant l'article Poofer1 au groupe Miss Gadgets items addicts !
  
  Il y a également une ligne spéciale, la ligne FILTER par défaut. Cette ligne sera utilisée lorsqu'aucune condition des autres lignes n'a été remplie. Par exemple:
  
  
  FILTER=ELSE-->MyRoBoT // Invitation au groupe MyRoBoT, si aucune autre ligne FILTER n'au eu sa condition remplie

Haut de page

Plugins (Extensions) pour Apez

Pré requis

Avez-vous bien suivi les General Aspects avant de continuer ?

Avez-vous déjà essayé de rezzer et configurer un OnTouch avant de continuer ?

Introduction

Apez est une marque bien connue dans SL. Leur but est de fournir une large plage de services cohérents. Parmi eux, 2 sont intéressants pour une intégration avec le service Group.Invitor:

• Apez.iVend: système de vendors en réseau. Une intégration permet d'inviter les personnes ayant acheté un article
• Apez.AutoLease: système locatif en réseau. Une intégration permet d'inviter les personnes qui louent (un magasin ou une parcelle par exemple), et d'éjecter à la fin du temps de location.
  • Ceci peut être totalement réalisé seulement par le service Group.Invitor.Fixed: en effet, seul ce service permet les éjections, ou encore de travailler avec des groupes à inscription non libre (les groupes utilisés dans les malls sont rarement ouverts à tous...)

Apez.iVend

Introduction

Techniquement, il y a plusieurs moyens de s'intégrer avec Apez.iVend.

MyRoBoT a choisi le plus simple d'entre eux, spécialement pour les situations d'utilisateurs d'Apez ayant un grand nombre de serveurs ou de vendors: Le plugin Apez utilise en effet le système de notification automatique de Apez: ANS (Automatic Notification System).

Avec une seule prim, vous pouvez décider des invitations à effectuer pour tous les articles que vous vendez avec Apez à travers tout SL !

Démarrage Rapide

Si vous souhaitez rapidement mettre en place une intégration avec Apez.iVend, suivez la procédure suivante::

• Rezzer une prim. Cette prim sera le lieu de traitement des invitations
• Copier les fichiers suivants dans votre nouvelle prim:
  • Group.Invitor.ANS.Apez 1.5
  • Group.Invitor.Config 1.5
  • SimpleServiceBot-GroupInvitor 1.5
  • Choisissez un des scripts StringsAndLoader.XX, où XX correspond à la langue de votre choix: fr pour français, de pour allemand, en pour anglais, es pour espagnol
• Vous verrez qu'à l'exécution, les scripts vous indiqueront une clé UUID. Notez-la, c'est important. Touchez la prim de nouveau pour revoir la clé si vous l'avez manquée
• Allez sur le site web de Apez, dans les préférences (Vous pourriez avoir à vous connecter et à cliquer de nouveau ce lien)
• Activer l'ANS
• Choisissez la méthode email, et indiquer votre clé UUID dans la case à coté, en utilisant la syntaxe suivante: UUID@lsl.secondlife.com (remplacer UUID par votre clé)
• Si vous le souhaitez, entre le code de sécurité ANS de votre choix: choisissez ce que vous voulez, mais gardez cette information confidentielle
• Mettez à jour la configuration
• De retour dans Second Life, ouvrez la notecard que vous avez mis dans la nouvelle prim, nommée Group.Invitor.Config 1.5
• La 1ère ligne commençant par LANG= est la langue choisie. Entrez ici la langue que vous avez choisie en choisissant le fichier StringsAndLoader.XX. Par exemple, si vous avez choisi le français, vous devriez entrer:
  
  
  LANG=fr
  
  
• A côté de la chaine CHECK=, mettez votre code de sécurité ANS, si vous en avez choisi un (ou laissez vide à côté dans le cas contraire). Par exemple, si vous avez entré le code de sécurité 1234, cette ligne devra être:
  
  
  CHECK=1234
  
  
• Remplacez la dernière ligne de la notecard par son équivalent avec votre groupe. Par exemple, si votre groupe était MyRoBoT, cette ligne devrait être:
  
  
  FILTER=ELSE-->MyRoBoT
  
  
• Enregistrer la notecard. Vous verrez que la machine vérifie sa syntaxe.
• Si la vérification est un succès, vous avez terminé ! La machine invitera les personnes lors d'un achat au groupe que vous avez indiqué (à condition qu'il n'y ait pas de condition de spam ou de filtrage) !

Manuel d'utilisation

Suivez la procédure de démarrage rapide ci-dessus. Ensuite vous pouvez régler les détails avec toutes les options disponibles.

La notecard respecte les règles suivantes:

• La notecard est basée sur une collection de paires clé=valeur, une paire par ligne.
• Les lignes vides, ou commençant par // sont considérées comme des commentaires, et non prises en compte.
• Il peut y avoir un maximum de 20 lignes (commentaires inclus)

Les clés disponibles pour Apez sont:

• LANG: les valeurs réglables sont actuellement fr, en, de et es, pour français, anglais, allemand, et espagnol. Vous DEVEZ indiquer la même langue que celle utilisée avec le script StringsAndLoader.XX choisi. Sinon le chargement de la notecard échouera. La valeur par défaut est en
• AGEFILTER: la valeur acceptée est une quantité, avec un signe < ou > juste avant. Par exemple, >12 signifie de ne PAS inviter les avatars plus vieux que 12 mois de SL. Vous pouvez aussi utiliser <, pour ne PAS inviter les avatars plus jeunes qu'un âge donné. La valeur par défaut est >36
• CHECK: vous devez mettre ici la valeur que vous avez indiquée dans la page web ANS Apez pour le champ de sécurité ANS. Si vous ne l'avez pas utilisé, laissez ce champ vide ou enlevez la lige. La valeur par défaut est vide
• VERBOSE: la valeur est soit YES, soit NO. YES signifie que les scripts afficheront des commentaires sur chaque invitation. La valeur par défaut est YES.
  • La valeur EXTRA est aussi acceptée, et signifie qu'en plus des commentaires du choix YES, les scripts afficheront les notifications reçues depuis le service
• ANTISPAM: la valeur acceptée est un nombre, entre 86400 et 2592000. Il s'agit d'une durée, exprimée en secondes, et signifie que vous pouvez régler la durée pour l'antispam entre 1 jour et 30 jours. La valeur par défaut est de 30 jours.
• FILTER: il doit y avoir au moins une ligne démarrant par FILTER, et il peut y en avoir plusieurs. Chaque ligne sera prise en compte, l'une après l'autre, dans l'ordre où elles apparaissent.. Chaque ligne doit être formatée de la même manière:
  
  
  FILTER=Clé-->Valeur-->Nom du groupe|||Role
  
  
  • où Clé est la clé envoyée par les services Apez, grâce à l'ANS.
  • où Valeur est la valeur à vérifier
  • où |||Role est optionnel, et fonctionne uniquement avec le service Group.Invitor.Fixed service
  
  Les clés envoyées par le système de notification ANS de Apez sont:
  
  • Grid: toujours 'SL:Production'
  • Timestamp: temps formaté à la manière Unix
  • Timestamp8601: temps formatté comme suit: yyyy-MM-ddTHH:mm:ssZ
  • Type: toujours 'Purchase'
  • Currency: LLD ou USD
  • SaleID: nombre
  • TransactionID: nombre
  • ProductID: nombre
  • ItemID: nombre
  • ProductName: nom du produit vendu
  • ItemName: nom du produit vendu
  • InventoryName: nom de l'objet qui a été livré lors de la vente
  • CollectionName: nom de la collection à laquelle appartient le produit qui a été vendu
  • PaymentGross: coût global de la vente, commissions incluses
  • PaymentShared: montant reversé pour les partages
  • PaymentCommission: coût de la commission
  • PaymentFee: coût de la commission
  • BuyerKey: clé UUID de l'avatar qui a payé
  • PayerKey: clé UUID de l'avatar qui a payé
  • BuyerName: nom de l'avatar qui a payé
  • PayerName: nom de l'avatar qui a payé
  • SellerKey: clé UUID de l'avatar vendeur
  • SellerName: nom de l'avatar qui était le vendeur
  • MerchantKey: clé UUID du marchand
  • MerchantName: nom de l'avatar qui est le marchand
  • ReceiverKey: clé UUID de l'avatar qui a reçu l'article
  • ReceiverName: nom de l'avatar qui a reçu l'article
  • Region: nom de la région où la vente a eu lieu. Par exemple 'XStream80'
  • Location: position du vendor dans la région où la vente a eu lieu, en format x,y,z. Par exemple: 100, 230, 20
  
  

  Les scripts vont comparer la valeur inscrite dans la notecard avec celle envoyée par ANS. Cela donne une grande flexibilité quant à vos choix !

  Voici quelques exemples de lignes FILTER:

  FILTER=PaymentGross-->0-->Freebies Owners // Invitation de tout avatar achetant un de vos freebies dans le groupe Freebies Owners
  FILTER=Region-->XStream80-->MyRoBoT // Invitation de tout avatar achetant dans la région XStream80 au groupe MyRoBoT
  FILTER=ProductName-->Poofer1-->Miss Gadgets items addicts ! // Invitation de tout avatar achetant l'article Poofer1 au groupe Miss Gadgets items addicts !
  FILTER=CollectionName-->My collec-->Group|||Role // Invitation de tout avatars achetant un produit appartenant à la collection My collec dans le groupe Group, avec le rôle Role
  
  Il y a également une ligne spéciale, la ligne FILTER par défaut. Cette ligne sera utilisée lorsqu'aucune condition des autres lignes n'a été remplie. Par exemple:
  
  
  FILTER=ELSE-->MyRoBoT // Invitation au groupe MyRoBoT, si aucune autre ligne FILTER n'au eu sa condition remplie

Apez.AutoLease

Introduction

Il n'y a malheureusement aucun moyen de rassembler toutes les requêtes pour AutoLease en un unique point dans SL.

Vous allez donc devoir rajouter des scripts dans toutes vos unités AutoLease dans le jeu.

Démarrage Rapide

Si vous souhaitez rapidement mettre en place une intégration avec une unité Apez.AutoLease, suivez la procédure suivante::

• Copier les fichiers suivants dans votre unité Apez.AutoLease:
  • Group.Invitor.Apez.AutoLease 1.5
  • Group.Invitor.Config 1.5
  • SimpleServiceBot-GroupInvitor 1.5
  • Choisissez un des scripts StringsAndLoader.XX, où XX correspond à la langue de votre choix: fr pour français, de pour allemand, en pour anglais, es pour espagnol
• Ouvrez la notecard que vous avez juste mis dans votre Apez.AutoLease nommée Group.Invitor.Config 1.5
• La 1ère ligne commençant par LANG= est la langue choisie. Entrez ici la langue que vous avez choisie en choisissant le fichier StringsAndLoader.XX. Par exemple, si vous avez choisi le français, vous devriez entrer:
  
  LANG=fr
  
  
• Repérez le ligne commençant par GROUP=. Remplacez le texte après le signe = avec le nom exact de votre groupe. Par exemple, si votre groupe est MyRoBoT, cette ligne devrait contenir:
  
  
  GROUP=MyRoBoT

• Enregistrer la notecard. Vous verrez que la machine vérifie sa syntaxe.
• Si la vérification est un succès, vous avez terminé ! Les avatars seront invités au groupe lors d'une 1ère location !

Manuel d'utilisation

Suivez la procédure de démarrage rapide ci-dessus. Ensuite vous pouvez régler les détails avec toutes les options disponibles.

La notecard respecte les règles suivantes:

• La notecard est basée sur une collection de paires clé=valeur, une paire par ligne.
• Les lignes vides, ou commençant par // sont considérées comme des commentaires, et non prises en compte.
• Il peut y avoir un maximum de 20 lignes (commentaires inclus)

Les clés disponibles pour Apez.AutoLease sont:

• LANG: les valeurs réglables sont actuellement fr, en, de et es, pour français, anglais, allemand, et espagnol. Vous DEVEZ indiquer la même langue que celle utilisée avec le script StringsAndLoader.XX choisi. Sinon le chargement de la notecard échouera. La valeur par défaut est en
• VERBOSE: la valeur est soit YES, soit NO. YES signifie que les scripts afficheront des commentaires sur chaque invitation. La valeur par défaut est YES.
  • La valeur EXTRA est aussi acceptée, et signifie qu'en plus des commentaires du choix YES, les scripts afficheront les notifications reçues depuis le service
• GROUP: la valeur doit être le nom de votre groupe. Vous pouvez également rajouter un rôle, séparé du nom de groupe par le signe |||. Le rôle ne fonctionne qu'avec le service Group.Invitor.Fixed. Exemple:
  
  
  GROUP=MyRoBoT|||Officers
  
  
• EJECTACTION: cette ligne ne sera prise en compte qu'avec le service Group.Invitor.Fixed service. 2 valeurs peuvent être indiquées: LeaveGroup ou LeaveRole.
  • Avec LeaveGroup, un avatar atteignant la fin de sa location sera éjecté du groupe.
  • Avec LeaveRole, un avatar atteignant la fin de sa location sera éjecté du rôle indiqué dans GROUP (si aucun rôle n'a été indiqué, ou si ce rôle est Everyone, l'avatar sera éjecté du groupe)
  • Si aucune valeur n'est indiqué, ou si la ligne EJECTACTION n'existe pas, l'avatar restera dans le groupe à la fin de sa location. Ceci est le comportement par défaut, et le seul utilisable avec le service Group.Invitor (Edition Standard)

Haut de page

Plugins (Extensions) pour Hippo

Pré requis

Avez-vous bien suivi les General Aspects avant de continuer ?

Avez-vous déjà essayé de rezzer et configurer un OnTouch avant de continuer ?

Introduction

Hippo est une marque bien connue dans SL. Leur but est de fournir une large plage de services cohérents. Parmi eux, 2 sont intéressants pour une intégration avec le service Group.Invitor:

• HippoVend: système de vendors en réseau. Une intégration permet d'inviter les personnes ayant acheté un article
• HippoRent: système locatif en réseau. Une intégration permet d'inviter les personnes qui louent (un magasin ou une parcelle par exemple), et d'éjecter à la fin du temps de location.
  • Ceci peut être totalement réalisé seulement par le service Group.Invitor.Fixed: en effet, seul ce service permet les éjections, ou encore de travailler avec des groupes à inscription non libre (les groupes utilisés dans les malls sont rarement ouverts à tous...)

HippoVend

Introduction

Techniquement, il y a plusieurs moyens de s'intégrer avec HippoVend.

MyRoBoT a choisi le plus simple d'entre eux, spécialement pour les situations d'utilisateurs de Hippo ayant un grand nombre de serveurs ou de vendors: Le plugin Hippo utilise en effet le système de notification automatique de Hippo: ANS (Automatic Notification System). Vous aurez cependant à modifier la configuration de tous les serveurs à utiliser avec le Group.Invitor.

Avec une seule prim, il est possible de décider des invitations à effectuer pour tous les articles que vous vendez avec Hippo à travers tout SL !

Démarrage Rapide

Si vous souhaitez rapidement mettre en place une intégration avec une unité HippoVend, suivez la procédure suivante::

• Rezzer une nouvelle prim. Cette prim sera le lieu de traitement des invitations
• Copier les fichiers suivants dans votre unité HippoVend:
  • Group.Invitor.ANS.Hippo 1.5
  • Group.Invitor.Config 1.5
  • SimpleServiceBot-GroupInvitor 1.5
  • Choisissez un des scripts StringsAndLoader.XX, où XX correspond à la langue de votre choix: fr pour français, de pour allemand, en pour anglais, es pour espagnol
• Ouvrez la notecard que vous avez juste mis dans la nouvelle prim, nommée Group.Invitor.Config 1.5
• Vous verrez qu'à l'exécution, les scripts vous indiqueront une clé UUID. Notez-la, c'est important. Touchez la prim de nouveau pour revoir la clé si vous l'avez manquée
• Allez là ou se trouve votre serveur Hippo. Allez voir son contenu et ouvrez la notecard appelée _config
• Dans la notecard, ajoutez la ligne suivante (si non présente):
  
  
  USE ANS: Yes
  
  
• Ajoutez également une autre ligne, en utilisant la clé UUID de la prim que vous avez rezzée (voir un peu plus haut). Par exemple, si la clé UUID de notre prim est 06ca2690-35ad-11df-9879-0800200c9a66, vous aurez à entrer cette ligne:
  
  
  ANS EMAIL: 06ca2690-35ad-11df-9879-0800200c9a66@lsl.secondlife.com
  
  
• Enregistrez la notecard. Effectuez les mêmes modifications dans tous les serveurs Hippo contenant des articles pour lesquels vous désirez gérer des invitations
• Retournez à l'endroit où vous avez rezzé votre prim. Allez voir son contenu, et ouvrez la notecard nommée Group.Invitor.Config 1.5
• La 1ère ligne commençant par LANG= est la langue choisie. Entrez ici la langue que vous avez choisie en choisissant le fichier StringsAndLoader.XX. Par exemple, si vous avez choisi le français, vous devriez entrer:
  
  
  LANG=fr
  
  
• Remplacez la dernière ligne de la notecard par son équivalent avec votre groupe. Par exemple, si votre groupe était MyRoBoT, cette ligne devrait être:
  
  
  FILTER=ELSE-->MyRoBoT
  
  
• Enregistrer la notecard. Vous verrez que la machine vérifie sa syntaxe.
• Si la vérification est un succès, vous avez terminé ! La machine invitera les personnes lors d'un achat au groupe que vous avez indiqué (à condition qu'il n'y ait pas de condition de spam ou de filtrage) !

Manuel d'utilisation

Suivez la procédure de démarrage rapide ci-dessus. Ensuite vous pouvez régler les détails avec toutes les options disponibles.

La notecard respecte les règles suivantes:

• La notecard est basée sur une collection de paires clé=valeur, une paire par ligne.
• Les lignes vides, ou commençant par // sont considérées comme des commentaires, et non prises en compte.
• Il peut y avoir un maximum de 20 lignes (commentaires inclus)

Les clés disponibles pour HippoVend sont:

• LANG: les valeurs réglables sont actuellement fr, en, de et es, pour français, anglais, allemand, et espagnol. Vous DEVEZ indiquer la même langue que celle utilisée avec le script StringsAndLoader.XX choisi. Sinon le chargement de la notecard échouera. La valeur par défaut est en
• AGEFILTER: la valeur acceptée est une quantité, avec un signe < ou > juste avant. Par exemple, >12 signifie de ne PAS inviter les avatars plus vieux que 12 mois de SL. Vous pouvez aussi utiliser <, pour ne PAS inviter les avatars plus jeunes qu'un âge donné. La valeur par défaut est >36
• VERBOSE: la valeur est soit YES, soit NO. YES signifie que les scripts afficheront des commentaires sur chaque invitation. La valeur par défaut est YES.
  • La valeur EXTRA est aussi acceptée, et signifie qu'en plus des commentaires du choix YES, les scripts afficheront les notifications reçues depuis le service
• ANTISPAM: la valeur acceptée est un nombre, entre 86400 et 2592000. Il s'agit d'une durée, exprimée en secondes, et signifie que vous pouvez régler la durée pour l'antispam entre 1 jour et 30 jours. La valeur par défaut est de 30 jours.
• FILTER: il doit y avoir au moins une ligne démarrant par FILTER, et il peut y en avoir plusieurs. Chaque ligne sera prise en compte, l'une après l'autre, dans l'ordre où elles apparaissent.. Chaque ligne doit être formatée de la même manière:
  
  
  FILTER=Clé-->Valeur-->Nom du groupe|||Role
  
  
  • où Clé est la clé envoyée par les services Hippo, grâce à l'ANS.
  • où Valeur est la valeur à vérifier
  • où |||Role est optionnel, et fonctionne uniquement avec le service Group.Invitor.Fixed service
  
  Les clés envoyées par le système de notification ANS de Hippo sont:
  
  • Grid: toujours 'SL:Production'
  • Currency: SLL
  • TransactionID: nombre
  • ProductID: nombre
  • ProductName: nom du produit vendu
  • InventoryName: nom de l'objet qui a été livré lors de la vente
  • PaymentGross: coût global de la vente, commissions incluses
  • PaymentShared: montant reversé pour les partages
  • PaymentFee: coût de la commission
  • PayerKey: clé UUID de l'avatar qui a payé
  • PayerName: nom de l'avatar qui a payé
  • MerchantKey: clé UUID du marchand
  • MerchantName: nom de l'avatar qui est le marchand
  • ReceiverKey: clé UUID de l'avatar qui a reçu l'article
  • ReceiverName: nom de l'avatar qui a reçu l'article
  • Region: nom de la région où la vente a eu lieu. Par exemple 'XStream80'
  • Location: position du vendor dans la région où la vente a eu lieu, en format x,y,z. Par exemple: 100, 230, 20

Les scripts vont comparer la valeur inscrite dans la notecard avec celle envoyée par ANS. Cela donne une grande flexibilité quant à vos choix !

Voici quelques exemples de lignes FILTER:

Il y a également une ligne spéciale, la ligne FILTER par défaut. Cette ligne sera utilisée lorsqu'aucune condition des autres lignes n'a été remplie. Par exemple:

HippoRent

Introduction

Il n'y a malheureusement aucun moyen de rassembler toutes les requêtes pour HippoRent en un unique point dans SL.

Vous allez donc devoir rajouter des scripts dans toutes vos unités HippoRent dans le jeu.

Démarrage Rapide

Si vous souhaitez rapidement mettre en place une intégration avec une unité HippoRent, suivez la procédure suivante::

• Copier les fichiers suivants dans votre unité HippoRent:
  • Group.Invitor.HippoRent 1.5
  • Group.Invitor.Config 1.5
  • SimpleServiceBot-GroupInvitor 1.5
  • Choisissez un des scripts StringsAndLoader.XX, où XX correspond à la langue de votre choix: fr pour français, de pour allemand, en pour anglais, es pour espagnol
• Ouvrez la notecard que vous avez juste mis dans votre HippoRent, nommée Group.Invitor.Config 1.5
• La 1ère ligne commençant par LANG= est la langue choisie. Entrez ici la langue que vous avez choisie en choisissant le fichier StringsAndLoader.XX. Par exemple, si vous avez choisi le français, vous devriez entrer:
  
  LANG=fr
  
  
• Repérez le ligne commençant par GROUP=. Remplacez le texte après le signe = avec le nom exact de votre groupe. Par exemple, si votre groupe est MyRoBoT, cette ligne devrait contenir:
  
  
  GROUP=MyRoBoT

• Enregistrer la notecard. Vous verrez que la machine vérifie sa syntaxe.
• Si la vérification est un succès, vous avez terminé ! Les avatars seront invités au groupe lors d'une 1ère location !

Manuel d'utilisation

Suivez la procédure de démarrage rapide ci-dessus. Ensuite vous pouvez régler les détails avec toutes les options disponibles.

La notecard respecte les règles suivantes:

• La notecard est basée sur une collection de paires clé=valeur, une paire par ligne.
• Les lignes vides, ou commençant par // sont considérées comme des commentaires, et non prises en compte.
• Il peut y avoir un maximum de 20 lignes (commentaires inclus)

Les clés disponibles pour HippoRent sont:

• LANG: les valeurs réglables sont actuellement fr, en, de et es, pour français, anglais, allemand, et espagnol. Vous DEVEZ indiquer la même langue que celle utilisée avec le script StringsAndLoader.XX choisi. Sinon le chargement de la notecard échouera. La valeur par défaut est en
• VERBOSE: la valeur est soit YES, soit NO. YES signifie que les scripts afficheront des commentaires sur chaque invitation. La valeur par défaut est YES.
  • La valeur EXTRA est aussi acceptée, et signifie qu'en plus des commentaires du choix YES, les scripts afficheront les notifications reçues depuis le service
• GROUP: la valeur doit être le nom de votre groupe. Vous pouvez également rajouter un rôle, séparé du nom de groupe par le signe |||. Le rôle ne fonctionne qu'avec le service Group.Invitor.Fixed. Exemple:
  
  
  GROUP=MyRoBoT|||Officers
  
  
• EJECTACTION: cette ligne ne sera prise en compte qu'avec le service Group.Invitor.Fixed service. 2 valeurs peuvent être indiquées: LeaveGroup ou LeaveRole.
  • Avec LeaveGroup, un avatar atteignant la fin de sa location sera éjecté du groupe.
  • Avec LeaveRole, un avatar atteignant la fin de sa location sera éjecté du rôle indiqué dans GROUP (si aucun rôle n'a été indiqué, ou si ce rôle est Everyone, l'avatar sera éjecté du groupe)
  • Si aucune valeur n'est indiqué, ou si la ligne EJECTACTION n'existe pas, l'avatar restera dans le groupe à la fin de sa location. Ceci est le comportement par défaut, et le seul utilisable avec le service Group.Invitor (Edition Standard)

Haut de page

Plugin (Extension) JEVN

Pré requis

Avez-vous bien suivi les General Aspects avant de continuer ?

Avez-vous déjà essayé de rezzer et configurer un OnTouch avant de continuer ?

Introduction

JEVN est une marque bien connue dans SL. Leur but est de fournir un service de vendors reliés en réseau.

Une intégration de Group.Invitor et JEVN permet d'inviter les personnes au moment où elles ont acheté un article !

Techniquement, il y a plusieurs moyens de s'intégrer avec JEVN. MyRoBoT a choisi le  plus simple d'entre eux, spécialement pour les situations d'utilisateurs de JEVN ayant un grand nombre de serveurs JEVN: Le plugin JEVN utilise en effet le système de notification AUX_KEY de JEVN.

Vous trouverez plus d'information à ce sujet dans le manuel JEVN, paragraphe 2.2.3.5.

Avec une seule prim, il est possible de décider des invitations à effectuer pour tous les articles que vous vendez avec JEVN à travers tout SL !

Démarrage Rapide

Si vous souhaitez rapidement mettre en place une intégration avec JEVN, suivez la procédure suivante::

• Rezzer une prim. Cette prim sera le lieu de traitement des invitations
• Copier les fichiers suivants dans votre nouvelle prim:
  • Group.Invitor.ANS.JEVN 1.5
  • Group.Invitor.Config 1.5
  • SimpleServiceBot-GroupInvitor 1.5
  • Choisissez un des scripts StringsAndLoader.XX, où XX correspond à la langue de votre choix: fr pour français, de pour allemand, en pour anglais, es pour espagnol
• Vous verrez qu'à l'exécution, les scripts vous indiqueront une clé UUID. Notez-la, c'est important. Touchez la prim de nouveau pour revoir la clé si vous l'avez manquée
• Aller là ou se trouve votre serveur JEVN, et ouvrez la notecard _config qui se trouve a l'intérieur
• Dans la notecard, ajoutez une ligne, en utilisant la clé UUID de la prim que vous avez rezzée (voir un peu plus haut). Par exemple, si la clé UUID de notre prim est 06ca2690-35ad-11df-9879-0800200c9a66, vous aurez à entrer cette ligne:
  
  
  aux_key1:06ca2690-35ad-11df-9879-0800200c9a66
  
  Cela va forcer le serveur à envoyer une notification à la prim que vous avez rezzée, pour chaque vente
  

• Enregistrez la notecard. Effectuez les mêmes modifications dans tous les serveurs JEVN contenant des articles pour lesquels vous désirez gérer des invitations
• Retournez à l'endroit où vous avez rezzé votre prim. Allez voir son contenu, et ouvrez la notecard nommée Group.Invitor.Config 1.5
• La 1ère ligne commençant par LANG= est la langue choisie. Entrez ici la langue que vous avez choisie en choisissant le fichier StringsAndLoader.XX. Par exemple, si vous avez choisi le français, vous devriez entrer:
  
  
  LANG=fr
  
  
• Remplacez la dernière ligne de la notecard par son équivalent avec votre groupe. Par exemple, si votre groupe était MyRoBoT, cette ligne devrait être:
  
  
  FILTER=ELSE-->MyRoBoT
  
  
• Enregistrer la notecard. Vous verrez que la machine vérifie sa syntaxe.
• Si la vérification est un succès, vous avez terminé ! La machine invitera les personnes lors d'un achat au groupe que vous avez indiqué (à condition qu'il n'y ait pas de condition de spam ou de filtrage) !

Manuel d'utilisation

Suivez la procédure de démarrage rapide ci-dessus. Ensuite vous pouvez régler les détails avec toutes les options disponibles.

La notecard respecte les règles suivantes:

• La notecard est basée sur une collection de paires clé=valeur, une paire par ligne.
• Les lignes vides, ou commençant par // sont considérées comme des commentaires, et non prises en compte.
• Il peut y avoir un maximum de 20 lignes (commentaires inclus)

Les clés disponibles pour JEVN sont:

• LANG: les valeurs réglables sont actuellement fr, en, de et es, pour français, anglais, allemand, et espagnol. Vous DEVEZ indiquer la même langue que celle utilisée avec le script StringsAndLoader.XX choisi. Sinon le chargement de la notecard échouera. La valeur par défaut est en
• AGEFILTER: la valeur acceptée est une quantité, avec un signe < ou > juste avant. Par exemple, >12 signifie de ne PAS inviter les avatars plus vieux que 12 mois de SL. Vous pouvez aussi utiliser <, pour ne PAS inviter les avatars plus jeunes qu'un âge donné. La valeur par défaut est >36
• VERBOSE: la valeur est soit YES, soit NO. YES signifie que les scripts afficheront des commentaires sur chaque invitation. La valeur par défaut est YES.
  • La valeur EXTRA est aussi acceptée, et signifie qu'en plus des commentaires du choix YES, les scripts afficheront les notifications reçues depuis le service
• ANTISPAM: la valeur acceptée est un nombre, entre 86400 et 2592000. Il s'agit d'une durée, exprimée en secondes, et signifie que vous pouvez régler la durée pour l'antispam entre 1 jour et 30 jours. La valeur par défaut est de 30 jours.
• FILTER: il doit y avoir au moins une ligne démarrant par FILTER, et il peut y en avoir plusieurs. Chaque ligne sera prise en compte, l'une après l'autre, dans l'ordre où elles apparaissent.. Chaque ligne doit être formatée de la même manière:
  
  
  FILTER=Clé-->Valeur-->Nom du groupe|||Role
  
  
  • où Clé est la clé envoyée par JEVN par le système aux_key1.
  • où Valeur est la valeur à vérifier
  • où |||Role est optionnel, et fonctionne uniquement avec le service Group.Invitor.Fixed service
  
  Les clés envoyées par le système aux_key1 de JEVN sont:
  
  • Type: toujours 'Purchase'
  • Timestamp: date_heure
  • Currency: LLD
  • TransactionID: nombre
  • ProductName: nom du produit vendu
  • ItemName: nom du produit vendu
  • InventoryName: nom de l'objet qui a été livré lors de la vente
  • PaymentGross: coût global de la vente, commissions incluses
  • PayerKey: clé UUID de l'avatar qui a payé
  • PayerName: nom de l'avatar qui a payé
  • ReceiverKey: clé UUID de l'avatar qui a reçu l'article
  • ReceiverName: nom de l'avatar qui a reçu l'article
  • Region: nom de la région où la vente a eu lieu. Par exemple 'XStream80'
  • Location: position du vendor dans la région où la vente a eu lieu, en format x,y,z. Par exemple: 100, 230, 20
  • VendorName: nom du vendor où la vente a eu lieu
  
  

  Les scripts vont comparer la valeur inscrite dans la notecard avec celle envoyée par ANS. Cela donne une grande flexibilité quant à vos choix !

  Voici quelques exemples de lignes FILTER:

  FILTER=PaymentGross-->0-->Freebies Owners // Invitation de tout avatar achetant un de vos freebies dans le groupe Freebies Owners
  FILTER=Region-->XStream80-->MyRoBoT // Invitation de tout avatar achetant dans la région XStream80 au groupe MyRoBoT
  FILTER=ProductName-->Poofer1-->Miss Gadgets items addicts ! // Invitation de tout avatar achetant l'article Poofer1 au groupe Miss Gadgets items addicts !
  
  
  Il y a également une ligne spéciale, la ligne FILTER par défaut. Cette ligne sera utilisée lorsqu'aucune condition des autres lignes n'a été remplie. Par exemple:
  
  
  FILTER=ELSE-->MyRoBoT // Invitation au groupe MyRoBoT, si aucune autre ligne FILTER n'au eu sa condition remplie

Haut de page

Plugin (Extension) pour Palen Design

Pré requis

Avez-vous bien suivi les General Aspects avant de continuer ?

Avez-vous déjà essayé de rezzer et configurer un OnTouch avant de continuer ?

Introduction

Palen Designest une marque bien connue dans SL. Leur but est de fournir un service de vendors reliés en réseau.

Une intégration de Group.Invitor et Palen Design permet d'inviter les personnes au moment où elles ont acheté un article !

Techniquement, il y a plusieurs moyens de s'intégrer avec Palen Design. MyRoBoT a choisi le  plus simple d'entre eux, spécialement pour les situations d'utilisateurs de Palen Designayant un grand nombre de vendors ou serveurs: Le plugin Palen Design utilise en effet le système de relai de Palen Design.

Vous trouverez plus d'information à ce sujet dans le forum de Palen Design.

Avec une seule prim, il est possible de décider des invitations à effectuer pour tous les articles que vous vendez avec vos vendors Palen Design à travers tout SL !

Démarrage Rapide

Si vous souhaitez rapidement mettre en place une intégration avec Palen Design, suivez la procédure suivante::

• Rezzer un relai Palen Design et configurer la comme expliqué dans le forum Palen Design
• Copier les fichiers suivants dans votre nouvelle prim:
  • Group.Invitor.ANS.Palen 1.5
  • Group.Invitor.Config 1.5
  • SimpleServiceBot-GroupInvitor 1.5
  • Choisissez un des scripts StringsAndLoader.XX, où XX correspond à la langue de votre choix: fr pour français, de pour allemand, en pour anglais, es pour espagnol
• Ouvrez la notecard nommée Group.Invitor.Config 1.5
• La 1ère ligne commençant par LANG= est la langue choisie. Entrez ici la langue que vous avez choisie en choisissant le fichier StringsAndLoader.XX. Par exemple, si vous avez choisi le français, vous devriez entrer:
  
  
  LANG=fr
  
  
• Remplacez la dernière ligne de la notecard par son équivalent avec votre groupe. Par exemple, si votre groupe était MyRoBoT, cette ligne devrait être:
  
  
  FILTER=ELSE-->MyRoBoT
  
  
• Enregistrer la notecard. Vous verrez que la machine vérifie sa syntaxe.
• Si la vérification est un succès, vous avez terminé ! La machine invitera les personnes lors d'un achat au groupe que vous avez indiqué (à condition qu'il n'y ait pas de condition de spam ou de filtrage) !

Manuel d'utilisation

Suivez la procédure de démarrage rapide ci-dessus. Ensuite vous pouvez régler les détails avec toutes les options disponibles.

La notecard respecte les règles suivantes:

• La notecard est basée sur une collection de paires clé=valeur, une paire par ligne.
• Les lignes vides, ou commençant par // sont considérées comme des commentaires, et non prises en compte.
• Il peut y avoir un maximum de 20 lignes (commentaires inclus)

Les clés disponibles pour Palen Design sont:

• LANG: les valeurs réglables sont actuellement fr, en, de et es, pour français, anglais, allemand, et espagnol. Vous DEVEZ indiquer la même langue que celle utilisée avec le script StringsAndLoader.XX choisi. Sinon le chargement de la notecard échouera. La valeur par défaut est en
• AGEFILTER: la valeur acceptée est une quantité, avec un signe < ou > juste avant. Par exemple, >12 signifie de ne PAS inviter les avatars plus vieux que 12 mois de SL. Vous pouvez aussi utiliser <, pour ne PAS inviter les avatars plus jeunes qu'un âge donné. La valeur par défaut est >36
• VERBOSE: la valeur est soit YES, soit NO. YES signifie que les scripts afficheront des commentaires sur chaque invitation. La valeur par défaut est YES.
  • La valeur EXTRA est aussi acceptée, et signifie qu'en plus des commentaires du choix YES, les scripts afficheront les notifications reçues depuis le service
• ANTISPAM: la valeur acceptée est un nombre, entre 86400 et 2592000. Il s'agit d'une durée, exprimée en secondes, et signifie que vous pouvez régler la durée pour l'antispam entre 1 jour et 30 jours. La valeur par défaut est de 30 jours.
• FILTER: il doit y avoir au moins une ligne démarrant par FILTER, et il peut y en avoir plusieurs. Chaque ligne sera prise en compte, l'une après l'autre, dans l'ordre où elles apparaissent.. Chaque ligne doit être formatée de la même manière:
  
  
  FILTER=Clé-->Valeur-->Nom du groupe|||Role
  
  
  • où Clé est la clé envoyée par Palen Design, au travers de leur service de notification.
  • où Valeur est la valeur à vérifier
  • où |||Role est optionnel, et fonctionne uniquement avec le service Group.Invitor.Fixed service
  
  Les clés envoyées par le système de relai de Palen Design sont:
  
  • Type: toujours 'Purchase'
  • Currency: chaine de caractères
  • TransactionID: nombre
  • ProductID: nombre
  • ItemID: nombre
  • ProductName: nom du produit vendu
  • ItemName: nom du produit vendu
  • InventoryName: nom de l'objet qui a été livré lors de la vente
  • PaymentGross: coût global de la vente, commissions incluses
  • PaymentFee: commissions
  • PayerKey: clé UUID de l'avatar qui a payé
  • PayerName: nom de l'avatar qui a payé
  • ReceiverKey: clé UUID de l'avatar qui a reçu l'article
  • ReceiverName: nom de l'avatar qui a reçu l'article
  • MerchantKey: clé UUID du marchand
  • MerchantName: nom de l'avatar qui est le marchand

   

  Les scripts vont comparer la valeur inscrite dans la notecard avec celle envoyée par le relai. Cela donne une grande flexibilité quant à vos choix !

  Voici quelques exemples de lignes FILTER:

  FILTER=PaymentGross-->0-->Freebies Owners // Invitation de tout avatar achetant un de vos freebies dans le groupe Freebies Owners
  FILTER=ProductName-->Poofer1-->Miss Gadgets items addicts ! // Invitation de tout avatar achetant l'article Poofer1 au groupe Miss Gadgets items addicts !
  
  
  Il y a également une ligne spéciale, la ligne FILTER par défaut. Cette ligne sera utilisée lorsqu'aucune condition des autres lignes n'a été remplie. Par exemple:
  
  
  FILTER=ELSE-->MyRoBoT // Invitation au groupe MyRoBoT, si aucune autre ligne FILTER n'au eu sa condition remplie

Haut de page