Differences

This shows you the differences between two versions of the page.

--- virtualty:subscribe_me_subscriber_system_-_user_manual [2022/08/09 13:58] – [Configuration] wikimaster
+++ virtualty:subscribe_me_subscriber_system_-_user_manual [2024/11/27 09:33] (current) – wikimaster
@@ Line 2: / Line 2: @@
-Script version: 1.00\\
+Script version: 1.0\\
-Last update: 09/08/2022\\
+Last update: 27/11/2024\\
+\\
+\\
+More recent Versions:\\
+subscriberOwnerTerminal 1.0i50\\
+subscriber 3rd 1.0i14\\
+subscriber 1.0i15\\
+Subscriber addon 1.0i25\\
+\\
+\\
 ''Subscribe  Me!'' is a web based Off World Subscriber tool that allows your guests/customers to subscribe to an off world list that you can then use to send messagesin world and/or objects directly to your subscribers.\\
-There can be many different subscribers in different area of your sim or in different sims, and the system can be completely managed offline, even if a in world Owner Terminal is present as well.\\
+This tool is studied to be used either in your own sim/parcel, in parcels you have rez access and also can be given to third parties in order to be rezzed in their parcel/sim\\
 There is no limit in the number of subscriber you can have, and a single licence of this product covers up to 5 different active subscribers, while the number of subscriber terminals you can use is not limited at all.\\
 This is a fully operational tool that links Second Life™ with an external platform, accessible via your in-world name and a password that can be retrieved from the Virtualty Office. ([[http://maps.secondlife.com/secondlife/Falcata/70/154/26]])
+**IMPORTANT**\\
+The Owner Server has been updated at the last mesh, but the behaviour of the software has not changed, I will try to update the pics as soon as possible.
 ==== Basic elements ====
 The tool is made of two elements:\\
-  * ''[V] Subscriber Owner Terminal'' - The object contains a single script, ''subscriberOwnerTerminal x.y''
+  * ''[V] Subscribe Me! Owner'' - The owner terminal
-  * ''[V] Subscriber''  - The object contains a single script, ''subscriber x.y''
+  * ''[V] Subscribe Me!''  - The mesh subscriber, ready for you to use
-{{ :virtualty:subscribeme:screenshot_1.png?400 |}}
+  * ''[V] 3rd Party Subscribe Me!''  - The object contains a single script, that can be distributed to partner(s)
-{{ :virtualty:subscribeme:screenshot_2.png?400 |}}
+  * ''Subscriber AddOn!'' - The element that will be used to send items to the subscribers
-{{ :virtualty:subscribeme:screenshot_3.png?400 |}}
+{{ :virtualty:subscribeme:screenshot_14.png?400 |}}
 Plus of course the Management website, that can be reached at\\
 https://manageme.virtualty.space/users/login.php\\
@@ Line 23: / Line 36: @@
 ([[http://maps.secondlife.com/secondlife/Falcata/70/154/26]])\\
 Manage Me! is the primary place where to go to edit your Subscriber and create new ones, even if this can be done also in world.\\
+==== Functionalities ====
+These are the functionalities present at the moment in the tool:
+  * Define the message to be sent to the subscribers
+  * Possibility to send messages and/or objects to the subscribers
+  * Possibility to decide if the message will be sent as an IM or as a message from Virtualty Bot (VirtualtyPostmaster)
+  * Possibility to decide to present the user that click the subscriber with a window to decide if to subscribe or unsubscribe or just let the tool decide it automatically and autonomously(at the click it will be checked if the user is already subscribed. If they are subscribed the click will unsubscribe them, if they are not, it will subscribe them automatically)
+  * Possibility to configure an ad-hoc subscriber to give to 3rd parties (for instance in sims where you cannot rez or to add to huds)
+  * Offline configuration (you just create the subscriber in world, then you can set it up completely offline)
+  * Activate/deactivate the overtext on the Owner Terminal
+  * Statistics on the number of clicks/subscribers
+  * Multiple rezzable Addon elements that will be actually used to send the objects to the different subscribers (very important to use if you have a large list of subscribers - tested with ~40000 subscribers' list)
 ==== First Use ====
-Very simply, just rez the Owner terminal in your workshop/home or whereever you want, and rez the Subscriber where you desire.\\
+Very simply, just rez the Owner terminal in your workshop/home or wherever you want, and rez the Subscriber where you desire.\\
 After a few moments, you will receive an IM from VirtualtyPostmaster stating that the first configuration is finished and you can now activate the Subscriber:
 {{ :virtualty:subscribeme:screenshot_3.jpg?400 |}}
 If you now click on the Subscriber, one of the following two windows will open to you:
-{{ :virtualty:subscribeme:screenshot_1.jpg?400 |}}{{ :virtualty:subscribeme:screenshot_4.jpg?400 |}}
+{{ :virtualty:subscribeme:screenshot_1.jpg?400 |}}
-this of couse in case you have no Subscriber created or not.\\
+{{ :virtualty:subscribeme:screenshot_15.png?400 |}}
+this of course in case you have no Subscriber created or not.\\
 As you can see, if you have not already created a Subscriber, you can create one directly.\\
 After creating it, you will have to configure it completely in Manage Me! and, most importantly, Activate it.\\
 Once you have selected or created the Subscriber you want, a couple of messages will be sent to you:
-{{ :virtualty:subscribeme:screenshot_5.jpg?400 |}}
+{{ :virtualty:subscribeme:screenshot_16.png?400 |}}
-The subscriber is then absolutely ready to work.\\
+As you can see, you will be given a code.\\
-If for whatever reason you need to disable it, just click on it
+This code is the one to be used with the ''[V] 3rd Party Subscribe Me!'', if you want to give your own subscriber to 3rd parties or you want to use the script in huds or similar\\
-{{ :virtualty:subscribeme:screenshot_6.png?400 |}}
+{{ :virtualty:subscribeme:screenshot_17.png?400 |}}
+As per the short instructions, you just need to have the specific code in the description field of the object you want to use as a subscriber:\\
+{{ :virtualty:subscribeme:screenshot_18.png?400 |}}
+The subscriber is then absolutely ready to work. You can send it to whoever you want, and when it will be rezzed, it will automatically associate to your subscriber.\\
+Please note: you can either save the code you received when you configured the subscriber, or rez a new subscriber to receive a new code.\\
+Both codes will work and are unique, but I would suggest to just write the first one down somewhere and always use that one.\\
+If for whatever reason you need to disable it, just click on it:
+{{ :virtualty:subscribeme:screenshot_11.png?400 |}}
 Once you want to re-activate it, again just click on it\\
 Needless to say, this is valid only for the owner.
+\\
+Once you have configured completely the Subscriber in Manage Me! (please see next paragraph) you will have the following menu when clicking on the Owner Terminal and selecting a Subscriber:
+{{ :virtualty:subscribeme:screenshot_19.png?400 |}}
+The Overtext button has been added to turn the overtext OFF and ON as desired.\\
+\\
+\\
+This is the moment also to rez the AddOns.\\
+I would suggest to rez a subscriber for every 2000 subscribers. Of course you are more than allowed to rez more of them in order to have a better and faster deliver of the items to your subscribers.\\
+Each addon will take care of a subset of your subscribers, sending them what you have decided to. A red number over the subscriber will indicate how many subscribers have been already reached.\\
+If you see that one addon number is not increasing, click on it to restart it.\\
+You will be able to see also in manage me (and on the Owner terminal) how the sending is going:
+{{:virtualty:subscribeme:screenshot_22.png?400|}}
 ==== Configuration ====
@@ Line 58: / Line 105: @@
 We use a Bot (VirtualtyPostmaster) to deliver all the messages in world, receiving hence the information from a real avatar, and not an impersonal Instant Message. But of course you can feel free to select one or the other method of communication.\\
 Please note, that what you select here will be used also for the option to send a message from the in world Owner Terminal.\\
+You can also select if to show the subscribers a window or just let the subscriber manage the subscription and unsubscriptions:
+{{ :virtualty:subscribeme:screenshot_21.png?400 |}}
+{{ :virtualty:subscribeme:screenshot_20.png?400 |}}
 ==== Send Message ====
 It is possible to send messages to your subscribers directly from Manage Me!, with the limitation that they can only be sent via VirtualtyPostmaster\\
@@ Line 72: / Line 122: @@
 {{ :virtualty:subscribeme:screenshot_18.jpg?400 |}}
 Please note that this file HAS to be made with a specific and precise structure, as highlighted in the above picture.\\
+==== Link to Welcome Me! ====
+In case you also use our [[virtualty:welcome_me_welcome_mat_system_-_user_manual|Welcome Me! ]], you can activate the ''Subscribe'' option in it and link it here to your subscriber.\\
+Actually, the only thing to do is to select the (already active) Welcome me! welcome mat from the dropdown menu:\\
+{{ :virtualty:subscribeme:screenshot_19.jpg?400 |}}
+==== Q&A ====
+Normally, in case of errors you will receive a message from VirtualtyPostmaster stating the error and in some cases the Terminal may get Disabled.\\
+=== Error 14 ===
+> [07:23] VirtualtyPostmaster Resident: (Saved Thu Oct 06 15:30:40 2022)xxxx subscriber has been disabled for the following reason
+> Error 14: Wrong version of the software, please check with Virtualty
+> [07:23] VirtualtyPostmaster Resident: (Saved Thu Oct 06 15:30:42 2022)xxxx subscriber has been disabled - check your IMs for the reason
+The Subscriber (normally due to a bug in sl managing of encryption data) thinks that the version of your software is not correct.\\
+Just click again on the Owner Terminal, it will again check with the server for the version, and, most probably, you will not get the error anymore.\\
+=== Error 15 ===
+{{ :virtualty:subscribeme:screenshot_9.png?400 |}}
+The Subscriber has not been found, and this is normally a very good reason to disable the Terminal.\\
+It means that the system cannot find your avatar in the list of the avatars that are using the system.\\
+It is sometime due to a communication glitch, try please deleting the Terminal and rez a new one.\\
+=== Error 20 ===
+{{ :virtualty:subscribeme:screenshot_5.png?400 |}}
+Ops! You forgot to renew the subscription... \\
+You can do that at the Virtualty Office ([[http://maps.secondlife.com/secondlife/Falcata/70/154/26]])