https://wiki.casperdns.com/api.php?action=feedcontributions&user=24607dde-d704-4db7-afa0-d9edc17c926c&feedformat=atomCasperTech Wiki - User contributions [en]2024-03-28T17:15:43ZUser contributionsMediaWiki 1.35.0https://wiki.casperdns.com/index.php?title=Official_Avatars&diff=15357Official Avatars2024-01-12T10:47:28Z<p>24607dde-d704-4db7-afa0-d9edc17c926c: /* Support avatars */</p>
<hr />
<div>There have been some cases of users creating false accounts with our brands, possibly with the intention of defrauding our customers.<br />
<br />
For security purposes, we have listed all of our official avatars below. '''Be very careful about subtle mis-spellings of these names'''.<br />
<br />
<span style="color:red">CasperTech Staff will '''never''' ask for your password, and will '''never''' offer you unsolicited gift cards</span><br />
<br />
== Support avatars ==<br />
<br />
'''ONLY THESE AVATARS ARE AUTHORISED CASPERTECH REPRESENTATIVES'''<br />
<br />
* Casper Linden<br />
* Casper Warden<br />
* CasperHelp Resident<br />
* Cornelius Mole<br />
* Donald Mole<br />
* Norsk Mole<br />
* Norsk Himmel<br />
* Sphynx Soleil<br />
* FreyasFashions Resident / Freya Pixelbottom<br />
* Jules Catlyn<br />
* Norsk Resident / Norsk Evergreen<br />
* FreyasFinestJewels Resident<br />
* FreyasFinest Resident<br />
* FreyasBot Resident<br />
* CasperSupportSteve Resident<br />
* CasperSupportImmy Resident<br />
* CasperSupportKit Resident<br />
* CasperSupportDonald Resident<br />
<br />
== Other avatars ==<br />
<br />
These avatars exist and belong to us, but are not used for support purposes.<br />
<br />
* CasperVend Resident ('''NOT''' CasperVendor)<br />
* CasperVendCommission Resident<br />
* RezFree Resident<br />
* CasperTech Resident<br />
* CasperTechGridSurvey Resident<br />
* CasperTechDemo Resident<br />
* CasperDemo Resident<br />
* CasperLet Resident<br />
* CasperPanel Resident<br />
* CasperDNS Resident<br />
* CasperSafe Resident<br />
* PrimBay Engineer<br />
* PrimBay Mint<br />
* PrimBay Resident<br />
* GridStatusUpdate Resident<br />
* Group Resident<br />
* OrlandoVictimsFund Resident<br />
* ItWorksOnMyMachine Resident</div>24607dde-d704-4db7-afa0-d9edc17c926chttps://wiki.casperdns.com/index.php?title=Official_Avatars&diff=15354Official Avatars2023-12-13T23:18:01Z<p>24607dde-d704-4db7-afa0-d9edc17c926c: /* Support avatars */</p>
<hr />
<div>There have been some cases of users creating false accounts with our brands, possibly with the intention of defrauding our customers.<br />
<br />
For security purposes, we have listed all of our official avatars below. '''Be very careful about subtle mis-spellings of these names'''.<br />
<br />
<span style="color:red">CasperTech Staff will '''never''' ask for your password, and will '''never''' offer you unsolicited gift cards</span><br />
<br />
== Support avatars ==<br />
<br />
'''ONLY THESE AVATARS ARE AUTHORISED CASPERTECH REPRESENTATIVES'''<br />
<br />
* Casper Linden<br />
* Casper Warden<br />
* CasperHelp Resident<br />
* Donald Mole<br />
* Norsk Mole<br />
* Norsk Himmel<br />
* Sphynx Soleil<br />
* FreyasFashions Resident / Freya Pixelbottom<br />
* Jules Catlyn<br />
* Norsk Resident / Norsk Evergreen<br />
* FreyasFinestJewels Resident<br />
* FreyasFinest Resident<br />
* FreyasBot Resident<br />
* CasperSupportSteve Resident<br />
* CasperSupportImmy Resident<br />
* CasperSupportKit Resident<br />
* CasperSupportDonald Resident<br />
<br />
== Other avatars ==<br />
<br />
These avatars exist and belong to us, but are not used for support purposes.<br />
<br />
* CasperVend Resident ('''NOT''' CasperVendor)<br />
* CasperVendCommission Resident<br />
* RezFree Resident<br />
* CasperTech Resident<br />
* CasperTechGridSurvey Resident<br />
* CasperTechDemo Resident<br />
* CasperDemo Resident<br />
* CasperLet Resident<br />
* CasperPanel Resident<br />
* CasperDNS Resident<br />
* CasperSafe Resident<br />
* PrimBay Engineer<br />
* PrimBay Mint<br />
* PrimBay Resident<br />
* GridStatusUpdate Resident<br />
* Group Resident<br />
* OrlandoVictimsFund Resident<br />
* ItWorksOnMyMachine Resident</div>24607dde-d704-4db7-afa0-d9edc17c926chttps://wiki.casperdns.com/index.php?title=WebKiosk/Rental_Vendors&diff=15353WebKiosk/Rental Vendors2023-12-02T23:00:32Z<p>24607dde-d704-4db7-afa0-d9edc17c926c: /* Configuration Section */</p>
<hr />
<div>{|align=right<br />
|__TOC__<br />
|}<br />
<br />
= '''<span style="color:#00528c">About the New Rental Vendors</span>''' =<br />
<br />
The new rental vendors allow you to show your available (not locked or reserved) rentals on a dedicated CasperLet-specific vendor. <br />
<br />
These rental vendors have a red & white theme instead of a blue & white theme, and the button bar says "CasperLet". <br />
<br />
By default, the rental vendor will pull in ALL of your available rentals. Unless you have set a specific set of images for the rental (and these are set up on a per-unit basis), the default picture pulled in will be the grid's "map tile" for the entire region. <br />
<br />
Clicking the center panel will always pull up a teleport map to the rental. If you are the OWNER of the rental vendor, you will ALSO get the owner menu. <br />
<br />
When the default rental vendor is in use, it will rez a small beacon ball that will appear on the overhead map in the center panel to show WHERE (x and y coordinates) on the map the rental is. This beacon does NOT indicate height - only the x and y portion of the coordinates. This beacon is only temporary, and will go away after a minute or two.<br />
<br />
Rental vendors may be customised if you wish, the instructions on that are further down on this page.<br />
<br />
= '''<span style="color:#00528c">Setting Up Your Vendors </span>''' =<br />
<br />
:# Rez out a rental vendor from inventory<br />
:# Grant '''[[Debit_Permissions | Debit Perms]]''' - the rental vendor will not function without them. <br />
:# If you are re-rezzing a rental vendor that you '''already''' granted debit permissions to, it will not ask again. This is normal. <br />
:# Find the "CasperLet" logo on the button bar of the rental vendor <br />
:# Click the logo<br />
:# Take the link to the CasperPanel website<br />
:# You will arrive at the configuration page for THAT vendor. <br />
<br />
== Custom Available/Rented Textures for the Vendor ==<br />
<br />
{|<br />
|-<br />
|[[File:Images_in_rental_listing.png|300px|thumb|left|Click for larger version]]<br />
|-<br />
|}<br />
This selects custom textures to be displayed on the following items: <br />
:* Rental Vendors from this kit<br />
:* Kiosk-generated rental listings<br />
:* Rental listings embedded onto your domain<br />
<br />
This '''does not''' change any textures on rental units themselves. If you don't set custom textures, the rental vendor will simply pull in an image of the grid's map tile for that region. <br />
<br />
Right now, you will need to log in to CasperLet's '''[https://let.casperdns.com/ old site]''' to set this option. You will find it on the configuration page for the specific unit, at the top of the options, but '''NOT''' on the bulk page. (This is because many landlords would prefer to customise the texture for individual rentals with a picture of the rental itself.)<br />
<br />
== Complete Configuration Screen ==<br />
This image shows the entire configuration page for the rental vendor. <br />
<br />
{|<br />
|-<br />
|[[File:Rental_Vendor_Configuration.png|300px|thumb|left|Click for larger version]]<br />
|-<br />
|}<br />
<br />
Everything ABOVE the green "Configuration" bar is information about the rental vendor, the sim/region it's currently rezzed on, and the vendor owner.<br />
<br />
== Configuration Section ==<br />
This is a closeup of the configuration section, showing the options in use by default. <br />
<br />
{|<br />
|-<br />
|[[File:Rental_Vendor_-_Configuration_Panel.png|300px|thumb|left|Click for larger version]]<br />
|-<br />
|}<br />
<br />
'''Rental Profile:''' This is where an existing rental profile is chosen, or a new one created. See the '''[[Rental_Profiles | rental profiles]]''' page for more details on how to create new ones. <br />
<br />
'''Accept Payments:''' Allows people to pay for their rentals via that vendor. <br />
<br />
'''Show in Use:''' (off by default) Will show ALL rentals on the vendor, regardless of whether or not they're available. <br />
<br />
'''Floating Text:''' Toggles the display of floating (hover) text on the vendor. <br />
<br />
'''Smart Text:''' Toggles whether floating text is hidden when not in use. <br />
<br />
'''Show Beacon:''' Toggles whether or not the beacon is rezzed to indicate location of the rental on the map.<br />
<br />
= '''<span style="color:#00528c">No Gift Cards</span>''' =<br />
If you want to offer gift cards for use on vendors, you'll need to use the CasperVend/CasperLet integration instead. These rental vendors do '''not''' support gift cards.</div>24607dde-d704-4db7-afa0-d9edc17c926chttps://wiki.casperdns.com/index.php?title=Official_Avatars&diff=15352Official Avatars2023-11-29T22:01:23Z<p>24607dde-d704-4db7-afa0-d9edc17c926c: /* Support avatars */</p>
<hr />
<div>There have been some cases of users creating false accounts with our brands, possibly with the intention of defrauding our customers.<br />
<br />
For security purposes, we have listed all of our official avatars below. '''Be very careful about subtle mis-spellings of these names'''.<br />
<br />
<span style="color:red">CasperTech Staff will '''never''' ask for your password, and will '''never''' offer you unsolicited gift cards</span><br />
<br />
== Support avatars ==<br />
<br />
'''ONLY THESE AVATARS ARE AUTHORISED CASPERTECH REPRESENTATIVES'''<br />
<br />
* Casper Linden<br />
* Casper Warden<br />
* CasperHelp Resident<br />
* Donald Mole<br />
* Norsk Mole<br />
* Norsk Himmel<br />
* Sphynx Soleil<br />
* FreyasFashions Resident / Freya Pixelbottom<br />
* Jules Catlyn<br />
* Norsk Resident<br />
* FreyasFinestJewels Resident<br />
* FreyasFinest Resident<br />
* FreyasBot Resident<br />
* CasperSupportSteve Resident<br />
* CasperSupportImmy Resident<br />
* CasperSupportKit Resident<br />
* CasperSupportDonald Resident<br />
<br />
== Other avatars ==<br />
<br />
These avatars exist and belong to us, but are not used for support purposes.<br />
<br />
* CasperVend Resident ('''NOT''' CasperVendor)<br />
* CasperVendCommission Resident<br />
* RezFree Resident<br />
* CasperTech Resident<br />
* CasperTechGridSurvey Resident<br />
* CasperTechDemo Resident<br />
* CasperDemo Resident<br />
* CasperLet Resident<br />
* CasperPanel Resident<br />
* CasperDNS Resident<br />
* CasperSafe Resident<br />
* PrimBay Engineer<br />
* PrimBay Mint<br />
* PrimBay Resident<br />
* GridStatusUpdate Resident<br />
* Group Resident<br />
* OrlandoVictimsFund Resident<br />
* ItWorksOnMyMachine Resident</div>24607dde-d704-4db7-afa0-d9edc17c926chttps://wiki.casperdns.com/index.php?title=Current_Versions&diff=15351Current Versions2023-11-27T03:47:13Z<p>24607dde-d704-4db7-afa0-d9edc17c926c: /* Vendor Products */</p>
<hr />
<div>{|align=right<br />
|__TOC__<br />
|}<br />
<br />
== '''<span style="color:#00528c">Current Versions</span>''' ==<br />
<br />
Here are the current versions of CasperTech products. <br />
<br />
If you need to upgrade, see the '''[[CasperVend_2/Updating | Upgrades page]]''' for instructions. Remember, '''upgrades are free!''' <br />
<br />
=== '''Rental Products''' ===<br />
----<br />
'''CURRENT VERSIONS '''<br />
:* CasperLet DEMO - v1.54<br />
:* CasperLet - 1.54<br />
:* Door & Sign Full Perm Samples - v1.14<br />
:* DropBox - v2.70<br />
:* HippoRent Migration Toolkit - v2.0<br />
:* Mapper - v1.13<br />
:* Prim Counter - v2.16r3<br />
:* Remote relay Boxes & Meters - v1.17<br />
:* Web Kiosk & Vendor Expansion - v1.02<br />
<br />
'''VERSIONS NO LONGER SUPPORTED as of 1 April, 2023'''<br />
:* CasperLet units v1.53 and earlier<br />
:* DropBox v2.63 and earlier<br />
<br />
'''VERSIONS NO LONGER SUPPORTED as of 20th June, 2019'''<br />
:* DropBox - v2.50 and earlier<br />
<br />
'''VERSIONS NO LONGER SUPPORTED as of June 1st, 2017'''<br />
:* CasperLet 1.39 AND OLDER<br />
<br />
(v1.2x and older are '''no longer functional''' - the upgradebee will '''not''' work on versions this old, due to server changes, so they will need manual replacing to update. Simply redeliver to get the latest versions.)<br />
<br />
=== '''Vendor Products''' ===<br />
----<br />
:* CasperVend FatPack/Complete - 2.70<br />
:* DropBox - v2.70<br />
:* Gift Card Expansion - v3.02<br />
:* HoloVend Expansion - v2.23<br />
:* Lucky Chair Expansion - v2.10r2<br />
:* Midnight Madness Expansion - v2.10r2<br />
:* QuantityVend Expansion - v2.11r2<br />
:* TextureVend Expansion - v2.30<br />
:* Vendors (Premium) - 2.70<br />
:* Vendors (Free) - 2.70<br />
:* Redelivery Terminal v2.40 (November 2017)<br />
:* Event Vendor Replacement Script v2.70<br />
<br />
'''VERSIONS NO LONGER SUPPORTED as of 1 April, 2023'''<br />
:* CasperVend script v2.12 and earlier<br />
:* DropBox v2.63 and earlier<br />
:* HoloVend script v2.22 and earlier<br />
<br />
'''VERSIONS NO LONGER SUPPORTED as of 20th June, 2019'''<br />
:* DropBox - v2.50 and earlier<br />
<br />
=== '''Other Products''' ===<br />
----<br />
:* CasperTech CasperSafe - v1.48<br />
::* CasperSafe Enforcer - v1.46<br />
:* CasperTech Rez2 - v2.20 <br />
:* CasperTech SimpleSit - v1.92<br />
:* CasperTech Transporter - 1.40r2<br />
:* CasperUpdate - 1.5r2<br />
:* Let It Snow - v1.1r2<br />
:* Spinner - v1.11r2<br />
<br />
=== '''Retired - and Unsupported - Products''' ===<br />
----<br />
<br />
:* CasperTech Rez-Free - v1.58 <br />
:* CasperTech Rez-Free Premium - v1.58<br />
:* Titler Of Doom - v1.0 <br />
:* KKF Resizer v1.9r2<br />
:* EasyVend expansion (For migrating from E2V) - v2.02r2<br />
<br />
== '''<span style="color:#00528c">Changelogs</span>''' ==<br />
<br />
: '''[[CasperLet/ChangeLog | CasperLet Change Log]]'''<br />
: '''[[CasperSafe_Security_Orb/ChangeLog | CasperSafe ChangeLog]]'''<br />
: '''[[CasperVend_2/ChangeLog | CasperVend Change Log]] '''<br />
:: '''[[ChangeLog-HoloVend | HoloVend Changelog]]'''<br />
: '''[[CasperUpdate/ChangeLog | CasperUpdate Changelog]]'''<br />
: '''[[CasperVend_2/DropBoxes/ChangeLog | DropBox change Log]]'''<br />
: '''[[Rez2/ChangeLog | Rez2 Changelog]]'''<br />
: '''[[SimpleSit/ChangeLog | SimpleSit Changelog]]'''<br />
: '''[[Transporter/ChangeLog | Transporter Changelog]]'''</div>24607dde-d704-4db7-afa0-d9edc17c926chttps://wiki.casperdns.com/index.php?title=CasperVend_2/Customers_Page&diff=15350CasperVend 2/Customers Page2023-11-24T13:51:33Z<p>24607dde-d704-4db7-afa0-d9edc17c926c: /* Setting All Vendors for a Grid-wide / Store-wide Sale */</p>
<hr />
<div>[[File:German_flag.gif]] [[CasperVend_2/Customers_Page/DE | Schaue hier in Deutsch!]]<br />
{|align=right<br />
|__TOC__<br />
|}<br />
<br />
== '''<span style="color:#00528c">Setting All Vendors for a Grid-wide / Store-wide Sale</span>''' ==<br />
This will set '''all of your vendors, everywhere on the grid''', to this discount. <br />
<br />
<ol><br />
<li> Log in to Caspervend.com</li><br />
<li> Click "customers" tab</li><br />
<li> Up at the top, in the "customer rewards" box, click the "Add New" link</li><br />
<li> Fill in the minimum spend (for a store/grid-wide sale, you'll want "0") </li><br />
<li> Fill in the discount level. </li><br />
<li> Click "Add" - you won't get a message, but the page will refresh and show you the new discount level.</li><br />
<li> Ensure the "Apply reward as store credit, rather than an immediate discount" box is NOT ticked / enabled. </li><br />
<li> All set! When you're done with the sale, just click the "x" in front of the discount line to remove the discount.</li> <br />
</ol><br />
<br />
Remember that only '''ONE''' discount will apply for any given transaction - the largest discount that is currently available. <br />
<br />
=== So if I want to set all vendors for a 50% sale to everyone.... ===<br />
----<br />
<ol><br />
<li> Log in to Caspervend.com</li><br />
<li> Click "customers" tab</li><br />
<li> Up at the top, in the "customer rewards" box, click the "Add New" link</li><br />
<li> Set the minimum spend L$ box to: '''0'''</li><br />
<li> Set the % box to: '''50''' </li><br />
<li> Click "Add" - you won't get a message, but the page will refresh and show you the new discount level.</li><br />
<li> Ensure the "Apply reward as store credit, rather than an immediate discount" box is NOT ticked / enabled. </li><br />
<li> All set! </li><br />
</ol><br />
<br />
=== How do I remove the sale when I'm done? ===<br />
----<br />
For the above example of a 50% sale, you should see on your customers page (in addition to any other discounts you may have set): <br />
<br />
'''Minimum Spend % Discount'''<br />
[X] L$0 50%<br />
<br />
<ol> <br />
<li>Click the '''X''' at the start of the line with the discount you no longer want.</li><br />
<li>Page will refresh and remove that line. All set! </li><br />
</ol><br />
<br />
=== How do I exclude specific vendors from the sale? ===<br />
<br />
To exclude specific vendors from this sale method, for example at an event, you must set on the vendor(s) in question the option:-<br />
<br />
"Don't allow any discounts to be awarded (except the group & general discounts specified above)."<br />
<br />
When making that change to the vendor(s) you must then '''RESET the vendor inworld''' when using the [[CasperVend_2/Event_Vendor_Script|Event Vendor Replacement script]]<br />
<br />
== '''<span style="color:#00528c">"Spend" on Marketplace versus "Spend" inworld</span>''' ==<br />
If you have set up the Marketplace ANS feed properly, customer purchases ON Marketplace will accumulate towards the "spend" total for any loyalty options you have set up. <br />
<br />
However, any customer rewards you have set up will '''ONLY''' apply to purchases on inworld vendors.<br />
<br />
== '''<span style="color:#00528c">About The Loyalty Program Options </span>''' ==<br />
[[File:Loyalty_Program.png|300px|thumb|right|Click to see larger image]]<br />
Numbered options in this section refer to the image at the right. <br />
<br />
=== 1) Customer Rewards Box ===<br />
----<br />
This is where you set up your spending/discount tier levels. Click "Add New" (bottom middle of that darker box) to add a new spending/discount tier, and the percentage discount the customer will get after reaching that level.<br />
<br />
By default, discounts set will be issued as cash refunds. This behavior may be modified with the following options, marked 2 through 5 on the image to the right.<br />
<br />
=== 2) Discount Vs. Store Credit Option ===<br />
----<br />
Ticking/checking this box turns the discount into store credit instead of cash back. <br />
<br />
=== 3) Refund on Purchase Option ===<br />
----<br />
Ticking/Checking this box controls whether store credit is automatically refunded, or if it's only spendable via clicking the vendor and then selecting "buy" off the popup menu. This option has no effect if the 'store credit' option is not used.<br />
<br />
=== 4) Don't Allow "Buy As Gift" With Credit Option ===<br />
----<br />
This prevents the customer from using their store credit to purchase an item as a gift for someone else. So if you hire people and pay them in store credit, they can only use the store credit for purchases going to themselves. <br />
<br />
=== 5) Display As Reward Points Option ===<br />
----<br />
This option does NOT affect the amount the customer gets in any applicable loyalty bonus - it simply changes how it is displayed. <br />
<br />
This will change the customer loyalty message to say something to the effect of:<br />
''You will receive reward points for purchases from this vendor.'' <br />
''Spend L$___ more with us to qualify for even more bonus reward points on future purchases!''<br />
with an additional part depending on their spending level: <br />
<br />
If they have '''not''' spent enough to reach a discount tier, the additional part of the message will be: <br />
''You won't currently receive any discount for purchases from this vendor.''<br />
<br />
If they '''have''' spent enough to reach a discount tier, the additional part of the message will be: <br />
''You have ___ remaining reward points. To use them, touch the vendor, choose 'Buy' and then select 'Reward Points'.''<br />
<br />
==== &nbsp; Handy Tip====<br />
----<br />
Setting a high ratio of points to lindens will make customers think they have more money.<br />
<br />
== '''<span style="color:#00528c">Setting General Customer Loyalty Discounts</span>''' ==<br />
This is for setting your general loyalty discounts. These discounts will give "cash back" to customers who've purchased products totaling over the minimum level(s) you specify using these instructions. <br />
<br />
<ol><br />
<li> Log in to Caspervend.com</li><br />
<li> Click "customers" tab</li><br />
<li> Up at the top, in the "customer rewards" box, click the "Add New" link</li><br />
<li> Fill in the minimum spend level. This is for how much you want your customers to have spent in your store before getting this discount. </li><br />
<li> Fill in the discount level. </li><br />
<li> Click "Add" - you won't get a message, but the page will refresh and show you the new discount level.</li><br />
<li> All set! </li><br />
</ol><br />
::'''NOTE:'''<br />
::* Loyalty '''discounts''' will refund automatically when they happen. They are not saved for later use. If you are looking for the loyalty CREDIT system, see the next section.<br />
<br />
== '''<span style="color:#00528c">Setting General Customer Loyalty Credit (Store Credit)</span>''' ==<br />
<ol><br />
<li> Log in to Caspervend.com</li><br />
<li> Click "Customers" tab</li><br />
<li> Under the "Customer Rewards" box is a checkbox for "Apply reward as store credit..."</li><br />
<li> Check that box</li><br />
<li> Then, up at the top, in the "customer rewards" box, click the "Add New" link</li><br />
<li> Fill your chosen spend levels. This is for how much you want your customers to have spent in your store before getting the credit percentage. </li><br />
<li> Click "save" </li><br />
<li> All set!</li><br />
</ol><br />
<br />
::'''NOTE:''' <br />
::* Store credit is NOT refunded UNTIL the customer buys something. <br />
::* Only an amount up to the value of the purchase is refunded. The rest remains "on the account" for future use.<br />
<br />
== '''<span style="color:#00528c">Setting Discounts For Specific Customers</span>''' ==<br />
This is used for when you want to give a special discount to a specific person, rather than to a group of people who've spent x-amount. <br />
<ol><br />
<li> Log in to Caspervend.com</li><br />
<li> Click "customers" tab</li><br />
<li> Find the customer's name in the list</li><br />
<li> On the "Discount" column, find the "set" button for that customer and click it</li><br />
<li> Fill in the percentage discount in the white box and click save</li><br />
<li> All set! </li><br />
</ol><br />
<br />
== '''<span style="color:#00528c">Giving (Individual) Customers a Credit Balance</span>''' ==<br />
This is used for when you want to give a credit balance to a specific customer. <br />
<ol><br />
<li> Log in to Caspervend.com</li><br />
<li> Click "customers" tab</li><br />
<li> Find the customer's name in the list</li><br />
<li> On the "Balance" column, find the "set" button for that customer and click it</li><br />
<li> Fill in the L$ amount in the white box and click save</li><br />
<li> All set! </li><br />
</ol><br />
<br />
== '''<span style="color:#00528c">How Customers Check Their Loyalty Program Levels</span>''' ==<br />
# Customer clicks any vendor<br />
# Customer chooses "discounts" from the popup menu<br />
# Customer will be presented with another popup that gives the following information: <br />
::* Total amount spent so far (or total points gained so far)<br />
::* Current cash-back discount level, if any<br />
::* How much they need to spend for the next loyalty tier<br />
::* What their loyalty level will be at the next tier, if set<br />
::* Existing credit balance they have, if any<br />
<br />
== '''<span style="color:#00528c">A Word on Price Overrides</span>''' ==<br />
<br />
If you have a price override set [[CasperVend_2/Vendor_Discounts#Setting_a_Price_Override_on_a_Vendor | on a vendor]] or [[CasperVend_2/Profiles_and_groups#Setting_Price_Overrides_on_Profiles | on a profile]], the price override '''WILL''' override the global discount as outlined on this page.<br />
<br />
== '''<span style="color:#00528c">FAQ / Troubleshooting</span>''' ==<br />
<br />
: '''Q. If you have two discounts (one set for all, and one set for a group) - does the larger one override the smaller, or do they both apply? '''<br />
:: '''A.''' The largest discount applies to the transaction, the other(s) do not.<br />
<br />
== '''<span style="color:#00528c">Not What You Were Looking For?</span>''' ==<br />
<br />
If this doesn't answer the "How do I...?" question you have, perhaps you need the page on [[CasperVend_2/Profiles_and_groups | profile discounts and overrides]] or the one for [[CasperVend_2/Vendor_Discounts | vendor discounts and overrides]] instead? <br />
<br />
&nbsp;</div>24607dde-d704-4db7-afa0-d9edc17c926chttps://wiki.casperdns.com/index.php?title=CasperVend_2/Customers_Page&diff=15349CasperVend 2/Customers Page2023-11-22T14:59:37Z<p>24607dde-d704-4db7-afa0-d9edc17c926c: /* Setting All Vendors for a Grid-wide / Store-wide Sale */</p>
<hr />
<div>[[File:German_flag.gif]] [[CasperVend_2/Customers_Page/DE | Schaue hier in Deutsch!]]<br />
{|align=right<br />
|__TOC__<br />
|}<br />
<br />
== '''<span style="color:#00528c">Setting All Vendors for a Grid-wide / Store-wide Sale</span>''' ==<br />
This will set '''all of your vendors, everywhere on the grid''', to this discount. <br />
<br />
<ol><br />
<li> Log in to Caspervend.com</li><br />
<li> Click "customers" tab</li><br />
<li> Up at the top, in the "customer rewards" box, click the "Add New" link</li><br />
<li> Fill in the minimum spend (for a store/grid-wide sale, you'll want "0") </li><br />
<li> Fill in the discount level. </li><br />
<li> Click "Add" - you won't get a message, but the page will refresh and show you the new discount level.</li><br />
<li> Ensure the "Automatically refund available store credit on purchase" box is ticked / enabled. </li><br />
<li> All set! When you're done with the sale, just click the "x" in front of the discount line to remove the discount.</li> <br />
</ol><br />
<br />
Remember that only '''ONE''' discount will apply for any given transaction - the largest discount that is currently available. <br />
<br />
=== So if I want to set all vendors for a 50% sale to everyone.... ===<br />
----<br />
<ol><br />
<li> Log in to Caspervend.com</li><br />
<li> Click "customers" tab</li><br />
<li> Up at the top, in the "customer rewards" box, click the "Add New" link</li><br />
<li> Set the minimum spend L$ box to: '''0'''</li><br />
<li> Set the % box to: '''50''' </li><br />
<li> Click "Add" - you won't get a message, but the page will refresh and show you the new discount level.</li><br />
<li> Ensure the "Automatically refund available store credit on purchase" box is ticked / enabled. </li><br />
<li> All set! </li><br />
</ol><br />
<br />
=== How do I remove the sale when I'm done? ===<br />
----<br />
For the above example of a 50% sale, you should see on your customers page (in addition to any other discounts you may have set): <br />
<br />
'''Minimum Spend % Discount'''<br />
[X] L$0 50%<br />
<br />
<ol> <br />
<li>Click the '''X''' at the start of the line with the discount you no longer want.</li><br />
<li>Page will refresh and remove that line. All set! </li><br />
</ol><br />
<br />
=== How do I exclude specific vendors from the sale? ===<br />
<br />
To exclude specific vendors from this sale method, for example at an event, you must set on the vendor(s) in question the option:-<br />
<br />
"Don't allow any discounts to be awarded (except the group & general discounts specified above)."<br />
<br />
When making that change to the vendor(s) you must then '''RESET the vendor inworld''' when using the [[CasperVend_2/Event_Vendor_Script|Event Vendor Replacement script]]<br />
<br />
== '''<span style="color:#00528c">"Spend" on Marketplace versus "Spend" inworld</span>''' ==<br />
If you have set up the Marketplace ANS feed properly, customer purchases ON Marketplace will accumulate towards the "spend" total for any loyalty options you have set up. <br />
<br />
However, any customer rewards you have set up will '''ONLY''' apply to purchases on inworld vendors.<br />
<br />
== '''<span style="color:#00528c">About The Loyalty Program Options </span>''' ==<br />
[[File:Loyalty_Program.png|300px|thumb|right|Click to see larger image]]<br />
Numbered options in this section refer to the image at the right. <br />
<br />
=== 1) Customer Rewards Box ===<br />
----<br />
This is where you set up your spending/discount tier levels. Click "Add New" (bottom middle of that darker box) to add a new spending/discount tier, and the percentage discount the customer will get after reaching that level.<br />
<br />
By default, discounts set will be issued as cash refunds. This behavior may be modified with the following options, marked 2 through 5 on the image to the right.<br />
<br />
=== 2) Discount Vs. Store Credit Option ===<br />
----<br />
Ticking/checking this box turns the discount into store credit instead of cash back. <br />
<br />
=== 3) Refund on Purchase Option ===<br />
----<br />
Ticking/Checking this box controls whether store credit is automatically refunded, or if it's only spendable via clicking the vendor and then selecting "buy" off the popup menu. This option has no effect if the 'store credit' option is not used.<br />
<br />
=== 4) Don't Allow "Buy As Gift" With Credit Option ===<br />
----<br />
This prevents the customer from using their store credit to purchase an item as a gift for someone else. So if you hire people and pay them in store credit, they can only use the store credit for purchases going to themselves. <br />
<br />
=== 5) Display As Reward Points Option ===<br />
----<br />
This option does NOT affect the amount the customer gets in any applicable loyalty bonus - it simply changes how it is displayed. <br />
<br />
This will change the customer loyalty message to say something to the effect of:<br />
''You will receive reward points for purchases from this vendor.'' <br />
''Spend L$___ more with us to qualify for even more bonus reward points on future purchases!''<br />
with an additional part depending on their spending level: <br />
<br />
If they have '''not''' spent enough to reach a discount tier, the additional part of the message will be: <br />
''You won't currently receive any discount for purchases from this vendor.''<br />
<br />
If they '''have''' spent enough to reach a discount tier, the additional part of the message will be: <br />
''You have ___ remaining reward points. To use them, touch the vendor, choose 'Buy' and then select 'Reward Points'.''<br />
<br />
==== &nbsp; Handy Tip====<br />
----<br />
Setting a high ratio of points to lindens will make customers think they have more money.<br />
<br />
== '''<span style="color:#00528c">Setting General Customer Loyalty Discounts</span>''' ==<br />
This is for setting your general loyalty discounts. These discounts will give "cash back" to customers who've purchased products totaling over the minimum level(s) you specify using these instructions. <br />
<br />
<ol><br />
<li> Log in to Caspervend.com</li><br />
<li> Click "customers" tab</li><br />
<li> Up at the top, in the "customer rewards" box, click the "Add New" link</li><br />
<li> Fill in the minimum spend level. This is for how much you want your customers to have spent in your store before getting this discount. </li><br />
<li> Fill in the discount level. </li><br />
<li> Click "Add" - you won't get a message, but the page will refresh and show you the new discount level.</li><br />
<li> All set! </li><br />
</ol><br />
::'''NOTE:'''<br />
::* Loyalty '''discounts''' will refund automatically when they happen. They are not saved for later use. If you are looking for the loyalty CREDIT system, see the next section.<br />
<br />
== '''<span style="color:#00528c">Setting General Customer Loyalty Credit (Store Credit)</span>''' ==<br />
<ol><br />
<li> Log in to Caspervend.com</li><br />
<li> Click "Customers" tab</li><br />
<li> Under the "Customer Rewards" box is a checkbox for "Apply reward as store credit..."</li><br />
<li> Check that box</li><br />
<li> Then, up at the top, in the "customer rewards" box, click the "Add New" link</li><br />
<li> Fill your chosen spend levels. This is for how much you want your customers to have spent in your store before getting the credit percentage. </li><br />
<li> Click "save" </li><br />
<li> All set!</li><br />
</ol><br />
<br />
::'''NOTE:''' <br />
::* Store credit is NOT refunded UNTIL the customer buys something. <br />
::* Only an amount up to the value of the purchase is refunded. The rest remains "on the account" for future use.<br />
<br />
== '''<span style="color:#00528c">Setting Discounts For Specific Customers</span>''' ==<br />
This is used for when you want to give a special discount to a specific person, rather than to a group of people who've spent x-amount. <br />
<ol><br />
<li> Log in to Caspervend.com</li><br />
<li> Click "customers" tab</li><br />
<li> Find the customer's name in the list</li><br />
<li> On the "Discount" column, find the "set" button for that customer and click it</li><br />
<li> Fill in the percentage discount in the white box and click save</li><br />
<li> All set! </li><br />
</ol><br />
<br />
== '''<span style="color:#00528c">Giving (Individual) Customers a Credit Balance</span>''' ==<br />
This is used for when you want to give a credit balance to a specific customer. <br />
<ol><br />
<li> Log in to Caspervend.com</li><br />
<li> Click "customers" tab</li><br />
<li> Find the customer's name in the list</li><br />
<li> On the "Balance" column, find the "set" button for that customer and click it</li><br />
<li> Fill in the L$ amount in the white box and click save</li><br />
<li> All set! </li><br />
</ol><br />
<br />
== '''<span style="color:#00528c">How Customers Check Their Loyalty Program Levels</span>''' ==<br />
# Customer clicks any vendor<br />
# Customer chooses "discounts" from the popup menu<br />
# Customer will be presented with another popup that gives the following information: <br />
::* Total amount spent so far (or total points gained so far)<br />
::* Current cash-back discount level, if any<br />
::* How much they need to spend for the next loyalty tier<br />
::* What their loyalty level will be at the next tier, if set<br />
::* Existing credit balance they have, if any<br />
<br />
== '''<span style="color:#00528c">A Word on Price Overrides</span>''' ==<br />
<br />
If you have a price override set [[CasperVend_2/Vendor_Discounts#Setting_a_Price_Override_on_a_Vendor | on a vendor]] or [[CasperVend_2/Profiles_and_groups#Setting_Price_Overrides_on_Profiles | on a profile]], the price override '''WILL''' override the global discount as outlined on this page.<br />
<br />
== '''<span style="color:#00528c">FAQ / Troubleshooting</span>''' ==<br />
<br />
: '''Q. If you have two discounts (one set for all, and one set for a group) - does the larger one override the smaller, or do they both apply? '''<br />
:: '''A.''' The largest discount applies to the transaction, the other(s) do not.<br />
<br />
== '''<span style="color:#00528c">Not What You Were Looking For?</span>''' ==<br />
<br />
If this doesn't answer the "How do I...?" question you have, perhaps you need the page on [[CasperVend_2/Profiles_and_groups | profile discounts and overrides]] or the one for [[CasperVend_2/Vendor_Discounts | vendor discounts and overrides]] instead? <br />
<br />
&nbsp;</div>24607dde-d704-4db7-afa0-d9edc17c926chttps://wiki.casperdns.com/index.php?title=Official_Avatars&diff=15347Official Avatars2023-11-07T18:14:40Z<p>24607dde-d704-4db7-afa0-d9edc17c926c: /* Support avatars */</p>
<hr />
<div>There have been some cases of users creating false accounts with our brands, possibly with the intention of defrauding our customers.<br />
<br />
For security purposes, we have listed all of our official avatars below. '''Be very careful about subtle mis-spellings of these names'''.<br />
<br />
<span style="color:red">CasperTech Staff will '''never''' ask for your password, and will '''never''' offer you unsolicited gift cards</span><br />
<br />
== Support avatars ==<br />
<br />
'''ONLY THESE AVATARS ARE AUTHORISED CASPERTECH REPRESENTATIVES'''<br />
<br />
* Casper Warden<br />
* CasperHelp Resident<br />
* Donald Mole<br />
* Norsk Mole<br />
* Norsk Himmel<br />
* Sphynx Soleil<br />
* FreyasFashions Resident / Freya Pixelbottom<br />
* Jules Catlyn<br />
* Norsk Resident<br />
* FreyasFinestJewels Resident<br />
* FreyasFinest Resident<br />
* FreyasBot Resident<br />
* CasperSupportSteve Resident<br />
* CasperSupportImmy Resident<br />
* CasperSupportKit Resident<br />
* CasperSupportDonald Resident<br />
<br />
== Other avatars ==<br />
<br />
These avatars exist and belong to us, but are not used for support purposes.<br />
<br />
* CasperVend Resident ('''NOT''' CasperVendor)<br />
* CasperVendCommission Resident<br />
* RezFree Resident<br />
* CasperTech Resident<br />
* CasperTechGridSurvey Resident<br />
* CasperTechDemo Resident<br />
* CasperDemo Resident<br />
* CasperLet Resident<br />
* CasperPanel Resident<br />
* CasperDNS Resident<br />
* CasperSafe Resident<br />
* PrimBay Engineer<br />
* PrimBay Mint<br />
* PrimBay Resident<br />
* GridStatusUpdate Resident<br />
* Group Resident<br />
* OrlandoVictimsFund Resident<br />
* ItWorksOnMyMachine Resident</div>24607dde-d704-4db7-afa0-d9edc17c926chttps://wiki.casperdns.com/index.php?title=Updating&diff=15346Updating2023-10-14T16:33:25Z<p>24607dde-d704-4db7-afa0-d9edc17c926c: /* How Do I Use the UpgradeBee? */</p>
<hr />
<div>{|align=right<br />
|__TOC__<br />
|}<br />
[[File:German_flag.gif]] [[CasperVend_2/Updating/DE | Schaue hier in Deutsch!]]<br />
= '''<span style="color:#00528c">Upgrading From CasperVend Free To Premium OR FatPack</span>''' =<br />
If you're currently using CasperVend Free, you can upgrade to CasperVend Premium really easily! <br />
<br />
The steps are simple: <br />
# Rez out the Premium or FatPack shipping crate on land where you can run scripts.<br />
# Click the shipping crate.<br />
# You can accept or decline the folder it gives you, it doesn't matter which you do.<br />
# Wait for the shipping crate to disappear.<br />
<br />
There is NO need to replace existing vendors or dropboxes, or to even run an UpgradeBee! The web server will be notified that you have purchased the upgrade, and they should stop taking the 5% commission automatically.<br />
<br />
= '''<span style="color:#00528c">How to Get the Latest Version</span>''' =<br />
There are many ways to get the latest versions of your CasperTech products:<br />
<br />
Check the '''[[Current_Versions | Current Versions]]''' to see what the latest version is and compare it against the one you have. <br />
<br />
==== Use a Redelivery Terminal ====<br />
----<br />
ANY CasperVend redelivery terminal (it's bundled with CasperVend), ANYWHERE on the grid can be used to get the updated version of any CasperTech product. It doesn't matter whether it's your terminal, Casper's terminal, or someone else's. <br />
<br />
However, if you use the one at the '''[https://maps.secondlife.com/secondlife/Caspertech/184/85/134 CasperTech store]''', it will sort all CasperTech purchases to the top of the list, making them much easier to find on the webpage.<br />
<br />
==== Use a Vendor ====<br />
----<br />
Touch the main panel of any CasperVend v2 vendor, and on the popup menu, use the "Redeliver" button to access our redelivery system.<br />
<br />
==== Visit the Overview tab on the CasperVend Website ====<br />
----<br />
All your purchases are listed on the CasperVend website on the overview tab for you to redeliver.<br />
<br />
==== Send "CasperTech Resident" an IM ====<br />
----<br />
You'll receive an automatic response within a minute or two which will guide you to getting your product update.<br />
<br />
==== Rez an older v2 version ====<br />
----<br />
Simply rez out a fresh copy of an older version from your inventory and you will be asked if you want an UpgradeBee to update the units. This applies to vendors, dropboxes, and rental units.<br />
<br />
= '''<span style="color:#00528c">Upgrading From Premium To Fatpack</span>''' =<br />
If you purchased the Premium pack within the last three (3) days, contact Casper Warden directly (via inworld IM, '''not''' by notecard - his notecards cap and he'll never see your notecard) to make arrangements for paying the difference and upgrading to the fatpack. After three days, you will need to buy the expansions separately.<br />
<br />
= '''<span style="color:#00528c">How to Update</span>''' =<br />
<br />
<br />
{{Information|The UpgradeBee will replace the old script with the new version, but does NOT change the name of the containing prim. You will have to rename the prim if you want it to reflect the new version. Popup/Touch menus always reflect the '''object name''' not the script version.}}<br />
<br />
=== CasperVend 2.x ===<br />
----<br />
Updating the CasperVend 2.x line is much easier - no need to replace your vendors, just let the UpgradeBee do all the work while you relax! (However, you '''will''' need to repeat this process in '''each''' sim/region that you have vendors.) <br />
<br />
:# Get the latest version of the CasperVend crate from a redelivery terminal (such as the ones at [https://maps.secondlife.com/secondlife/Caspertech/184/85/134 CasperTech])<br />
:# Unpack the UpgradeBee from the shipping crate<br />
:# Rez or wear/add (recommended) the UpgradeBee<br />
:# Click "Upgrade"<br />
:# Answer the orange debit perm windows <br />
:# When all the vendors are upgraded, the UpgradeBee will return to you<br />
:# All done - you may safely delete the Bee once it appears over your head<br />
<br />
=== CasperLet 1.x ===<br />
----<br />
CasperLet upgrades are simple<br />
:# Get the latest version of the CasperLet crate from a redelivery terminal (Such as the ones at [https://maps.secondlife.com/secondlife/Caspertech/184/85/134 CasperTech])<br />
:# Unpack the UpgradeBee from the shipping crate ("3) UpgradeBee CASPERLET ONLY vX.XX")<br />
:# Rez or wear/add (recommended) the UpgradeBee<br />
:# Click "Upgrade"<br />
:# Answer the orange debit perm windows <br />
:# When all the rental units are upgraded, the UpgradeBee will return to you<br />
:# All done - you may safely delete the Bee once it appears over your head<br />
:# Repeat on ALL sims where you have rental units<br />
<br />
If some of your units do not update correctly, please TOUCH them, choose Reset, wait a few moments, then run the bee again.<br />
<br />
=== DropBoxes 2.x ===<br />
----<br />
Updating DropBoxes is easy - no need to replace your DropBoxes, just let the UpgradeBee do all the work while you relax! (However, you '''will''' need to repeat this process in '''each''' sim/region that you have DropBoxes. You can check WHERE you have DropBoxes rezzed by visiting https://caspervend.casperdns.com/dropboxes.php ) <br />
<br />
:# Get the latest version of CasperVend, CasperLet or CasperUpdate from a redelivery terminal (such as the ones at [https://maps.secondlife.com/secondlife/Caspertech/184/85/134 CasperTech])<br />
:# Unpack the UpgradeBee DROPBOXES ONLY from the shipping crate<br />
:# Rez or wear/add (recommended) the UpgradeBee <br />
:# Click - Pop-Up - "Run Update"<br />
:# Grant debit permissions (since v2.70)<br />
:# When all the DropBoxes are upgraded, the UpgradeBee will return to you (if rezzed). You will get notified in local chat, whether rezzed or worn<br />
:# All done - you may safely delete or detach the Bee once it appears over your head<br />
<br />
=== CasperSafe ===<br />
----<br />
CasperSafe upgrades are simple<br />
<br />
:# Get the latest version of the CasperSafe crate from a redelivery terminal (such as the ones at [https://maps.secondlife.com/secondlife/Caspertech/184/85/134 CasperTech])<br />
:# Unpack the UpgradeBee from the shipping crate ("CasperSafe UpgradeBee x.xx")<br />
:# Rez or wear/add (recommended) the UpgradeBee<br />
:# Click the bee<br />
:# Click "UPDATE NOW"<br />
:# When all the orbs are updated, the UpgradeBee will return to its previous position<br />
:# All done - you may safely delete the Bee once it returns.<br />
:# Repeat on ALL sims where you have CasperSafe orbs<br />
<br />
=== Vendors / Dropboxes / Rental units gone to sleep? ===<br />
----<br />
:# Click the vendor / dropbox / rental unit<br />
:# Click "reset" or "resync" on the popup menu as appropriate<br />
:# Repeat with all units that have gone to sleep<br />
:# Wait a minute or two<br />
:# Run the UpgradeBee again<br />
<br />
'''VENDORS ONLY:''' If the units are '''really''' stubborn and refuse to update after that, then edit > reset scripts in selection for a hard reset of the unit(s) in question. Then run the UpgradeBee again.<br />
<br />
=== Version 2.08 of vendor script ===<br />
----<br />
This specific version was particularly difficult to upgrade from because it really didn't want to "wake up" from the idling state. <br />
<br />
If you still have any vendors with the 2.08 version of the script, you will likely need to manually replace the script (Right-Click > Edit > "contents" tab, delete the old and replace with the new) or outright replace the vendors.<br />
<br />
= '''<span style="color:#00528c">How Do I Use the UpgradeBee?</span>''' =<br />
You '''will''' have to grant debit perms many times as the vendors, dropboxes (since v2.70) and rental units come back online; '''THIS IS NORMAL''' because it is replacing the script (and the new script doesn't know about the permissions you gave the old script). If you don't answer them right away, they '''will''' pile up because the vendors will keep asking for them every minute or two. Please make sure it's the latest UpgradeBee, from the latest pack, of the product you want to update. Note that the CasperVend FatPack consists of many products, each with their own UpgradeBee.<br />
<br />
You will also need to do this in EACH sim/region that you have upgradeable products rezzed in. <br />
<br />
=== Always Use the Latest Bee ===<br />
----<br />
The UpgradeBee always ships with two scripts: <br />
:# The Bee script that controls the upgrade process<br />
:# The then-current version of the script it is designed to upgrade<br />
<br />
It will only use the script in its inventory, so an old UpgradeBee will '''never''' have a newer version of the script. You '''may''' be offered a new UpgradeBee when you rez an old one, but it depends on how old the older UpgradeBee is.<br />
<br />
==== For CasperLet ====<br />
----<br />
:* Rez or wear/add (recommended) the UpgradeBee<br />
:* Touch/click it<br />
:* Select "Upgrade" <br />
:* Wait until it finishes<br />
<br />
==== For Your Vendors ====<br />
----<br />
:* Rez or wear/add (recommended) the UpgradeBee<br />
:* Touch it<br />
:* Click "Update All"<br />
:* Wait until it finishes.<br />
<br />
==== For Vendors Going To Your Affiliates ====<br />
----<br />
For Affiliate vendors, you can do one of the following:<br />
<br />
:# Rez each of your affiliate vendors<br />
:# Use the UpgradeBee<br />
:# Pick them up <br />
:# Ship them out<br />
<br />
: '''Or....'''<br />
<br />
:# Send the UpgradeBee to each of your affiliates<br />
<br />
The first method is actually the '''recommended''' way, even though it's more of a hassle for you, the merchant. <br />
<br />
There's four big reasons why just sending the UpgradeBee to your affiliates isn't effective: <br />
:# Affiliates simply don't bother to update<br />
:# If you ship vendors as no-modify, it won't work anyway<br />
:# If they "lock" their vendors, it won't work anyway<br />
:# If you never update your original pack, you'll still be shipping out OLD vendors in the future. <br />
<br />
You always need the '''CURRENT''' UpgradeBee to upgrade vendors to the current version. Packing an old UpgradeBee in the box with affiliate vendors will not upgrade vendors to a newer version of the script than what the UpgradeBee has.<br />
<br />
= '''<span style="color:#00528c">Does My Product Use the UpgradeBee?</span>''' =<br />
<br />
==== These Products Use An UpgradeBee ====<br />
----<br />
* Affiliate expansion<br />
* CasperLet <br />
* CasperVend (both free and premium)<br />
* Holovend expansion<br />
* Lucky Chairs expansion<br />
* Mesh Expansion<br />
* Texture Vendors expansion<br />
<br />
==== These products do NOT ====<br />
----<br />
* Gift Cards<br />
* Let It Snow<br />
* Resizer<br />
* Rez-Free / Rez-Free Premium<br />
* SimpleSit<br />
* Spinner<br />
* Titler of Doom<br />
* Transporter<br />
* CasperUpdate<br />
<br />
= '''<span style="color:#00528c">Do I Have to Upgrade?</span>''' =<br />
Upgrades are rarely mandatory, but often recommended for bug fixes. <br />
<br />
DropBox upgrades are generally to work around delivery issue bugs that the Lab has introduced since the prior version. While these are not technically mandatory, please consider them as such, because the older versions often won't '''reliably''' deliver your items anymore. <br />
<br />
When we do force a major upgrade (such as the decomissioning of the v1 network in favor of the v2's), we give several months of notice so you have plenty of opportunity to upgrade the affected CasperTech product.<br />
<br />
= '''<span style="color:#00528c">What Do I Do If My Product Isn't Bee-Upgradable?</span>''' =<br />
If there's no updatebee for your product, you will need to set up any new versions manually that you want to use since there's no automated upgrade process.<br />
<br />
= '''<span style="color:#00528c">Not the "update" information you were looking for?</span>''' =<br />
If you were looking for how to send updated versions of products to customers via CasperVend, see the [[CasperVend_2/Updates | product updates]] page instead.<br />
<br />
= '''<span style="color:#00528c">FAQ / Troubleshooting</span>''' =<br />
<br />
: '''Q. Will the UgradeBee update vendors in all sims/regions I have vendors in or just one?''' <br />
<br />
:: '''A1.''' The UpgradeBee can only update vendors in one sim at a time - unfortunately the commands are not able to cross sim boundaries or go across the grid. Because updating the script requires a reset, you'll need to be present ''at some point'' (it can be "now" or "later") to answer all the yellow/orange debit permissions windows. Remember that your vendors will NOT function for your customers until you grant these debit permissions!<br />
<br />
:: This happens because the new updated script does NOT know - will never know - the permissions you granted to the old version. To you, this is "granting them again" but to the script this is "I never had permissions, so I have to ask." <br />
<br />
:: '''A2.''' If you have multiple locations, you can drop an upgrade bee at each one, start it going at each location, and then come back around later to answer all the debit permissions requests. Just remember that vendors won't work until debit permissions are granted, so don't leave them hanging too long if you can avoid it. <br />
<br />
: '''Q. When I rez out a vendor from inventory, should it always ask for debit permissions? ''' <br />
<br />
:: '''A.''' If you have PREVIOUSLY granted debit permissions, and then picked it up, or picked up a copy, then no, it will not ask again - it remembers debit permissions once granted, as long as it has not been updated or hard reset. <br />
<br />
: '''Q. When I use an updatebee, I have to manually grant debit permission for each vendor. I thought the vendors remembered this? '''<br />
<br />
:: '''A1.''' This happens because the new updated script does NOT know the permissions you granted to the old version. To you, this is "granting them again" but to the script this is "I never had permissions, so I have to ask."<br />
<br />
:: '''A2.''' This also happens if you drag-copy - the copy will ask for debit permissions, but the original will remember them. <br />
<br />
:: '''A3.''' If you manually reset (a/k/a hard reset) the vendors, it will act as a brand new script (because resetting scripts makes them flush their prior memory, which includes debit permissions.)<br />
<br />
: '''Q. If I update a product but keep the new name the same as the old one, can I just delete the old box from the dropbox, add the new, and not worry about relisting? '''<br />
<br />
:: '''A.''' Yes, as long as the name really is an exact match between the two.<br />
<br />
: '''Q. I ran the update, and it completed successfully, but the box / vendor / rental unit still says the old version number'''<br />
<br />
:: '''A.''' The updating process only replaces the *script* - it does not rename the object that the script is in. If you want the object's version number to match the version of the script, you'll need to replace it yourself.</div>24607dde-d704-4db7-afa0-d9edc17c926chttps://wiki.casperdns.com/index.php?title=Updating&diff=15345Updating2023-10-14T16:31:54Z<p>24607dde-d704-4db7-afa0-d9edc17c926c: /* How Do I Use the UpgradeBee? */</p>
<hr />
<div>{|align=right<br />
|__TOC__<br />
|}<br />
[[File:German_flag.gif]] [[CasperVend_2/Updating/DE | Schaue hier in Deutsch!]]<br />
= '''<span style="color:#00528c">Upgrading From CasperVend Free To Premium OR FatPack</span>''' =<br />
If you're currently using CasperVend Free, you can upgrade to CasperVend Premium really easily! <br />
<br />
The steps are simple: <br />
# Rez out the Premium or FatPack shipping crate on land where you can run scripts.<br />
# Click the shipping crate.<br />
# You can accept or decline the folder it gives you, it doesn't matter which you do.<br />
# Wait for the shipping crate to disappear.<br />
<br />
There is NO need to replace existing vendors or dropboxes, or to even run an UpgradeBee! The web server will be notified that you have purchased the upgrade, and they should stop taking the 5% commission automatically.<br />
<br />
= '''<span style="color:#00528c">How to Get the Latest Version</span>''' =<br />
There are many ways to get the latest versions of your CasperTech products:<br />
<br />
Check the '''[[Current_Versions | Current Versions]]''' to see what the latest version is and compare it against the one you have. <br />
<br />
==== Use a Redelivery Terminal ====<br />
----<br />
ANY CasperVend redelivery terminal (it's bundled with CasperVend), ANYWHERE on the grid can be used to get the updated version of any CasperTech product. It doesn't matter whether it's your terminal, Casper's terminal, or someone else's. <br />
<br />
However, if you use the one at the '''[https://maps.secondlife.com/secondlife/Caspertech/184/85/134 CasperTech store]''', it will sort all CasperTech purchases to the top of the list, making them much easier to find on the webpage.<br />
<br />
==== Use a Vendor ====<br />
----<br />
Touch the main panel of any CasperVend v2 vendor, and on the popup menu, use the "Redeliver" button to access our redelivery system.<br />
<br />
==== Visit the Overview tab on the CasperVend Website ====<br />
----<br />
All your purchases are listed on the CasperVend website on the overview tab for you to redeliver.<br />
<br />
==== Send "CasperTech Resident" an IM ====<br />
----<br />
You'll receive an automatic response within a minute or two which will guide you to getting your product update.<br />
<br />
==== Rez an older v2 version ====<br />
----<br />
Simply rez out a fresh copy of an older version from your inventory and you will be asked if you want an UpgradeBee to update the units. This applies to vendors, dropboxes, and rental units.<br />
<br />
= '''<span style="color:#00528c">Upgrading From Premium To Fatpack</span>''' =<br />
If you purchased the Premium pack within the last three (3) days, contact Casper Warden directly (via inworld IM, '''not''' by notecard - his notecards cap and he'll never see your notecard) to make arrangements for paying the difference and upgrading to the fatpack. After three days, you will need to buy the expansions separately.<br />
<br />
= '''<span style="color:#00528c">How to Update</span>''' =<br />
<br />
<br />
{{Information|The UpgradeBee will replace the old script with the new version, but does NOT change the name of the containing prim. You will have to rename the prim if you want it to reflect the new version. Popup/Touch menus always reflect the '''object name''' not the script version.}}<br />
<br />
=== CasperVend 2.x ===<br />
----<br />
Updating the CasperVend 2.x line is much easier - no need to replace your vendors, just let the UpgradeBee do all the work while you relax! (However, you '''will''' need to repeat this process in '''each''' sim/region that you have vendors.) <br />
<br />
:# Get the latest version of the CasperVend crate from a redelivery terminal (such as the ones at [https://maps.secondlife.com/secondlife/Caspertech/184/85/134 CasperTech])<br />
:# Unpack the UpgradeBee from the shipping crate<br />
:# Rez or wear/add (recommended) the UpgradeBee<br />
:# Click "Upgrade"<br />
:# Answer the orange debit perm windows <br />
:# When all the vendors are upgraded, the UpgradeBee will return to you<br />
:# All done - you may safely delete the Bee once it appears over your head<br />
<br />
=== CasperLet 1.x ===<br />
----<br />
CasperLet upgrades are simple<br />
:# Get the latest version of the CasperLet crate from a redelivery terminal (Such as the ones at [https://maps.secondlife.com/secondlife/Caspertech/184/85/134 CasperTech])<br />
:# Unpack the UpgradeBee from the shipping crate ("3) UpgradeBee CASPERLET ONLY vX.XX")<br />
:# Rez or wear/add (recommended) the UpgradeBee<br />
:# Click "Upgrade"<br />
:# Answer the orange debit perm windows <br />
:# When all the rental units are upgraded, the UpgradeBee will return to you<br />
:# All done - you may safely delete the Bee once it appears over your head<br />
:# Repeat on ALL sims where you have rental units<br />
<br />
If some of your units do not update correctly, please TOUCH them, choose Reset, wait a few moments, then run the bee again.<br />
<br />
=== DropBoxes 2.x ===<br />
----<br />
Updating DropBoxes is easy - no need to replace your DropBoxes, just let the UpgradeBee do all the work while you relax! (However, you '''will''' need to repeat this process in '''each''' sim/region that you have DropBoxes. You can check WHERE you have DropBoxes rezzed by visiting https://caspervend.casperdns.com/dropboxes.php ) <br />
<br />
:# Get the latest version of CasperVend, CasperLet or CasperUpdate from a redelivery terminal (such as the ones at [https://maps.secondlife.com/secondlife/Caspertech/184/85/134 CasperTech])<br />
:# Unpack the UpgradeBee DROPBOXES ONLY from the shipping crate<br />
:# Rez or wear/add (recommended) the UpgradeBee <br />
:# Click - Pop-Up - "Run Update"<br />
:# Grant debit permissions (since v2.70)<br />
:# When all the DropBoxes are upgraded, the UpgradeBee will return to you (if rezzed). You will get notified in local chat, whether rezzed or worn<br />
:# All done - you may safely delete or detach the Bee once it appears over your head<br />
<br />
=== CasperSafe ===<br />
----<br />
CasperSafe upgrades are simple<br />
<br />
:# Get the latest version of the CasperSafe crate from a redelivery terminal (such as the ones at [https://maps.secondlife.com/secondlife/Caspertech/184/85/134 CasperTech])<br />
:# Unpack the UpgradeBee from the shipping crate ("CasperSafe UpgradeBee x.xx")<br />
:# Rez or wear/add (recommended) the UpgradeBee<br />
:# Click the bee<br />
:# Click "UPDATE NOW"<br />
:# When all the orbs are updated, the UpgradeBee will return to its previous position<br />
:# All done - you may safely delete the Bee once it returns.<br />
:# Repeat on ALL sims where you have CasperSafe orbs<br />
<br />
=== Vendors / Dropboxes / Rental units gone to sleep? ===<br />
----<br />
:# Click the vendor / dropbox / rental unit<br />
:# Click "reset" or "resync" on the popup menu as appropriate<br />
:# Repeat with all units that have gone to sleep<br />
:# Wait a minute or two<br />
:# Run the UpgradeBee again<br />
<br />
'''VENDORS ONLY:''' If the units are '''really''' stubborn and refuse to update after that, then edit > reset scripts in selection for a hard reset of the unit(s) in question. Then run the UpgradeBee again.<br />
<br />
=== Version 2.08 of vendor script ===<br />
----<br />
This specific version was particularly difficult to upgrade from because it really didn't want to "wake up" from the idling state. <br />
<br />
If you still have any vendors with the 2.08 version of the script, you will likely need to manually replace the script (Right-Click > Edit > "contents" tab, delete the old and replace with the new) or outright replace the vendors.<br />
<br />
= '''<span style="color:#00528c">How Do I Use the UpgradeBee?</span>''' =<br />
You '''will''' have to grant debit perms many times as the vendors, dropboxes (since v2.70) and rental units come back online; '''THIS IS NORMAL''' because it is replacing the script (and the new script doesn't know about the permissions you gave the old script). If you don't answer them right away, they '''will''' pile up because the vendors will keep asking for them every minute or two. Please make sure it's the latest UpgradeBee, from the latest pack, of the product you want to update. Note that the CasperVend FatPack consists of many products, each with their own UpgradeBee.<br />
<br />
You will also need to do this in EACH sim/region that you have upgradeable products rezzed in. <br />
<br />
=== Always Use the Latest Bee ===<br />
----<br />
The UpgradeBee always ships with two scripts: <br />
:# The Bee script that controls the upgrade process<br />
:# The then-current version of the script it is designed to upgrade<br />
<br />
It will only use the script in its inventory, so an old UpgradeBee will '''never''' have a newer version of the script. You '''may''' be offered a new UpgradeBee when you rez an old one, but it depends on how old the older UpgradeBee is.<br />
<br />
==== For CasperLet ====<br />
----<br />
:* Rez the UpgradeBee<br />
:* Touch/click it<br />
:* Select "Upgrade" <br />
:* Wait until it finishes<br />
<br />
==== For Your Vendors ====<br />
----<br />
:* Rez the UpgradeBee<br />
:* Touch it<br />
:* Click "Update All"<br />
:* Wait until it finishes.<br />
<br />
==== For Vendors Going To Your Affiliates ====<br />
----<br />
For Affiliate vendors, you can do one of the following:<br />
<br />
:# Rez each of your affiliate vendors<br />
:# Use the UpgradeBee<br />
:# Pick them up <br />
:# Ship them out<br />
<br />
: '''Or....'''<br />
<br />
:# Send the UpgradeBee to each of your affiliates<br />
<br />
The first method is actually the '''recommended''' way, even though it's more of a hassle for you, the merchant. <br />
<br />
There's four big reasons why just sending the UpgradeBee to your affiliates isn't effective: <br />
:# Affiliates simply don't bother to update<br />
:# If you ship vendors as no-modify, it won't work anyway<br />
:# If they "lock" their vendors, it won't work anyway<br />
:# If you never update your original pack, you'll still be shipping out OLD vendors in the future. <br />
<br />
You always need the '''CURRENT''' UpgradeBee to upgrade vendors to the current version. Packing an old UpgradeBee in the box with affiliate vendors will not upgrade vendors to a newer version of the script than what the UpgradeBee has.<br />
<br />
= '''<span style="color:#00528c">Does My Product Use the UpgradeBee?</span>''' =<br />
<br />
==== These Products Use An UpgradeBee ====<br />
----<br />
* Affiliate expansion<br />
* CasperLet <br />
* CasperVend (both free and premium)<br />
* Holovend expansion<br />
* Lucky Chairs expansion<br />
* Mesh Expansion<br />
* Texture Vendors expansion<br />
<br />
==== These products do NOT ====<br />
----<br />
* Gift Cards<br />
* Let It Snow<br />
* Resizer<br />
* Rez-Free / Rez-Free Premium<br />
* SimpleSit<br />
* Spinner<br />
* Titler of Doom<br />
* Transporter<br />
* CasperUpdate<br />
<br />
= '''<span style="color:#00528c">Do I Have to Upgrade?</span>''' =<br />
Upgrades are rarely mandatory, but often recommended for bug fixes. <br />
<br />
DropBox upgrades are generally to work around delivery issue bugs that the Lab has introduced since the prior version. While these are not technically mandatory, please consider them as such, because the older versions often won't '''reliably''' deliver your items anymore. <br />
<br />
When we do force a major upgrade (such as the decomissioning of the v1 network in favor of the v2's), we give several months of notice so you have plenty of opportunity to upgrade the affected CasperTech product.<br />
<br />
= '''<span style="color:#00528c">What Do I Do If My Product Isn't Bee-Upgradable?</span>''' =<br />
If there's no updatebee for your product, you will need to set up any new versions manually that you want to use since there's no automated upgrade process.<br />
<br />
= '''<span style="color:#00528c">Not the "update" information you were looking for?</span>''' =<br />
If you were looking for how to send updated versions of products to customers via CasperVend, see the [[CasperVend_2/Updates | product updates]] page instead.<br />
<br />
= '''<span style="color:#00528c">FAQ / Troubleshooting</span>''' =<br />
<br />
: '''Q. Will the UgradeBee update vendors in all sims/regions I have vendors in or just one?''' <br />
<br />
:: '''A1.''' The UpgradeBee can only update vendors in one sim at a time - unfortunately the commands are not able to cross sim boundaries or go across the grid. Because updating the script requires a reset, you'll need to be present ''at some point'' (it can be "now" or "later") to answer all the yellow/orange debit permissions windows. Remember that your vendors will NOT function for your customers until you grant these debit permissions!<br />
<br />
:: This happens because the new updated script does NOT know - will never know - the permissions you granted to the old version. To you, this is "granting them again" but to the script this is "I never had permissions, so I have to ask." <br />
<br />
:: '''A2.''' If you have multiple locations, you can drop an upgrade bee at each one, start it going at each location, and then come back around later to answer all the debit permissions requests. Just remember that vendors won't work until debit permissions are granted, so don't leave them hanging too long if you can avoid it. <br />
<br />
: '''Q. When I rez out a vendor from inventory, should it always ask for debit permissions? ''' <br />
<br />
:: '''A.''' If you have PREVIOUSLY granted debit permissions, and then picked it up, or picked up a copy, then no, it will not ask again - it remembers debit permissions once granted, as long as it has not been updated or hard reset. <br />
<br />
: '''Q. When I use an updatebee, I have to manually grant debit permission for each vendor. I thought the vendors remembered this? '''<br />
<br />
:: '''A1.''' This happens because the new updated script does NOT know the permissions you granted to the old version. To you, this is "granting them again" but to the script this is "I never had permissions, so I have to ask."<br />
<br />
:: '''A2.''' This also happens if you drag-copy - the copy will ask for debit permissions, but the original will remember them. <br />
<br />
:: '''A3.''' If you manually reset (a/k/a hard reset) the vendors, it will act as a brand new script (because resetting scripts makes them flush their prior memory, which includes debit permissions.)<br />
<br />
: '''Q. If I update a product but keep the new name the same as the old one, can I just delete the old box from the dropbox, add the new, and not worry about relisting? '''<br />
<br />
:: '''A.''' Yes, as long as the name really is an exact match between the two.<br />
<br />
: '''Q. I ran the update, and it completed successfully, but the box / vendor / rental unit still says the old version number'''<br />
<br />
:: '''A.''' The updating process only replaces the *script* - it does not rename the object that the script is in. If you want the object's version number to match the version of the script, you'll need to replace it yourself.</div>24607dde-d704-4db7-afa0-d9edc17c926chttps://wiki.casperdns.com/index.php?title=Updating&diff=15344Updating2023-10-14T16:30:12Z<p>24607dde-d704-4db7-afa0-d9edc17c926c: /* CasperSafe */</p>
<hr />
<div>{|align=right<br />
|__TOC__<br />
|}<br />
[[File:German_flag.gif]] [[CasperVend_2/Updating/DE | Schaue hier in Deutsch!]]<br />
= '''<span style="color:#00528c">Upgrading From CasperVend Free To Premium OR FatPack</span>''' =<br />
If you're currently using CasperVend Free, you can upgrade to CasperVend Premium really easily! <br />
<br />
The steps are simple: <br />
# Rez out the Premium or FatPack shipping crate on land where you can run scripts.<br />
# Click the shipping crate.<br />
# You can accept or decline the folder it gives you, it doesn't matter which you do.<br />
# Wait for the shipping crate to disappear.<br />
<br />
There is NO need to replace existing vendors or dropboxes, or to even run an UpgradeBee! The web server will be notified that you have purchased the upgrade, and they should stop taking the 5% commission automatically.<br />
<br />
= '''<span style="color:#00528c">How to Get the Latest Version</span>''' =<br />
There are many ways to get the latest versions of your CasperTech products:<br />
<br />
Check the '''[[Current_Versions | Current Versions]]''' to see what the latest version is and compare it against the one you have. <br />
<br />
==== Use a Redelivery Terminal ====<br />
----<br />
ANY CasperVend redelivery terminal (it's bundled with CasperVend), ANYWHERE on the grid can be used to get the updated version of any CasperTech product. It doesn't matter whether it's your terminal, Casper's terminal, or someone else's. <br />
<br />
However, if you use the one at the '''[https://maps.secondlife.com/secondlife/Caspertech/184/85/134 CasperTech store]''', it will sort all CasperTech purchases to the top of the list, making them much easier to find on the webpage.<br />
<br />
==== Use a Vendor ====<br />
----<br />
Touch the main panel of any CasperVend v2 vendor, and on the popup menu, use the "Redeliver" button to access our redelivery system.<br />
<br />
==== Visit the Overview tab on the CasperVend Website ====<br />
----<br />
All your purchases are listed on the CasperVend website on the overview tab for you to redeliver.<br />
<br />
==== Send "CasperTech Resident" an IM ====<br />
----<br />
You'll receive an automatic response within a minute or two which will guide you to getting your product update.<br />
<br />
==== Rez an older v2 version ====<br />
----<br />
Simply rez out a fresh copy of an older version from your inventory and you will be asked if you want an UpgradeBee to update the units. This applies to vendors, dropboxes, and rental units.<br />
<br />
= '''<span style="color:#00528c">Upgrading From Premium To Fatpack</span>''' =<br />
If you purchased the Premium pack within the last three (3) days, contact Casper Warden directly (via inworld IM, '''not''' by notecard - his notecards cap and he'll never see your notecard) to make arrangements for paying the difference and upgrading to the fatpack. After three days, you will need to buy the expansions separately.<br />
<br />
= '''<span style="color:#00528c">How to Update</span>''' =<br />
<br />
<br />
{{Information|The UpgradeBee will replace the old script with the new version, but does NOT change the name of the containing prim. You will have to rename the prim if you want it to reflect the new version. Popup/Touch menus always reflect the '''object name''' not the script version.}}<br />
<br />
=== CasperVend 2.x ===<br />
----<br />
Updating the CasperVend 2.x line is much easier - no need to replace your vendors, just let the UpgradeBee do all the work while you relax! (However, you '''will''' need to repeat this process in '''each''' sim/region that you have vendors.) <br />
<br />
:# Get the latest version of the CasperVend crate from a redelivery terminal (such as the ones at [https://maps.secondlife.com/secondlife/Caspertech/184/85/134 CasperTech])<br />
:# Unpack the UpgradeBee from the shipping crate<br />
:# Rez or wear/add (recommended) the UpgradeBee<br />
:# Click "Upgrade"<br />
:# Answer the orange debit perm windows <br />
:# When all the vendors are upgraded, the UpgradeBee will return to you<br />
:# All done - you may safely delete the Bee once it appears over your head<br />
<br />
=== CasperLet 1.x ===<br />
----<br />
CasperLet upgrades are simple<br />
:# Get the latest version of the CasperLet crate from a redelivery terminal (Such as the ones at [https://maps.secondlife.com/secondlife/Caspertech/184/85/134 CasperTech])<br />
:# Unpack the UpgradeBee from the shipping crate ("3) UpgradeBee CASPERLET ONLY vX.XX")<br />
:# Rez or wear/add (recommended) the UpgradeBee<br />
:# Click "Upgrade"<br />
:# Answer the orange debit perm windows <br />
:# When all the rental units are upgraded, the UpgradeBee will return to you<br />
:# All done - you may safely delete the Bee once it appears over your head<br />
:# Repeat on ALL sims where you have rental units<br />
<br />
If some of your units do not update correctly, please TOUCH them, choose Reset, wait a few moments, then run the bee again.<br />
<br />
=== DropBoxes 2.x ===<br />
----<br />
Updating DropBoxes is easy - no need to replace your DropBoxes, just let the UpgradeBee do all the work while you relax! (However, you '''will''' need to repeat this process in '''each''' sim/region that you have DropBoxes. You can check WHERE you have DropBoxes rezzed by visiting https://caspervend.casperdns.com/dropboxes.php ) <br />
<br />
:# Get the latest version of CasperVend, CasperLet or CasperUpdate from a redelivery terminal (such as the ones at [https://maps.secondlife.com/secondlife/Caspertech/184/85/134 CasperTech])<br />
:# Unpack the UpgradeBee DROPBOXES ONLY from the shipping crate<br />
:# Rez or wear/add (recommended) the UpgradeBee <br />
:# Click - Pop-Up - "Run Update"<br />
:# Grant debit permissions (since v2.70)<br />
:# When all the DropBoxes are upgraded, the UpgradeBee will return to you (if rezzed). You will get notified in local chat, whether rezzed or worn<br />
:# All done - you may safely delete or detach the Bee once it appears over your head<br />
<br />
=== CasperSafe ===<br />
----<br />
CasperSafe upgrades are simple<br />
<br />
:# Get the latest version of the CasperSafe crate from a redelivery terminal (such as the ones at [https://maps.secondlife.com/secondlife/Caspertech/184/85/134 CasperTech])<br />
:# Unpack the UpgradeBee from the shipping crate ("CasperSafe UpgradeBee x.xx")<br />
:# Rez or wear/add (recommended) the UpgradeBee<br />
:# Click the bee<br />
:# Click "UPDATE NOW"<br />
:# When all the orbs are updated, the UpgradeBee will return to its previous position<br />
:# All done - you may safely delete the Bee once it returns.<br />
:# Repeat on ALL sims where you have CasperSafe orbs<br />
<br />
=== Vendors / Dropboxes / Rental units gone to sleep? ===<br />
----<br />
:# Click the vendor / dropbox / rental unit<br />
:# Click "reset" or "resync" on the popup menu as appropriate<br />
:# Repeat with all units that have gone to sleep<br />
:# Wait a minute or two<br />
:# Run the UpgradeBee again<br />
<br />
'''VENDORS ONLY:''' If the units are '''really''' stubborn and refuse to update after that, then edit > reset scripts in selection for a hard reset of the unit(s) in question. Then run the UpgradeBee again.<br />
<br />
=== Version 2.08 of vendor script ===<br />
----<br />
This specific version was particularly difficult to upgrade from because it really didn't want to "wake up" from the idling state. <br />
<br />
If you still have any vendors with the 2.08 version of the script, you will likely need to manually replace the script (Right-Click > Edit > "contents" tab, delete the old and replace with the new) or outright replace the vendors.<br />
<br />
= '''<span style="color:#00528c">How Do I Use the UpgradeBee?</span>''' =<br />
You '''will''' have to grant debit perms many times as the vendors and rental units come back online; '''THIS IS NORMAL''' because it is replacing the script (and the new script doesn't know about the permissions you gave the old script). If you don't answer them right away, they '''will''' pile up because the vendors will keep asking for them every minute or two. Please make sure it's the latest UpgradeBee, from the latest pack, of the product you want to update. Note that the CasperVend FatPack consists of many products, each with their own UpgradeBee.<br />
<br />
You will also need to do this in EACH sim/region that you have upgradeable products rezzed in. <br />
<br />
=== Always Use the Latest Bee ===<br />
----<br />
The UpgradeBee always ships with two scripts: <br />
:# The Bee script that controls the upgrade process<br />
:# The then-current version of the script it is designed to upgrade<br />
<br />
It will only use the script in its inventory, so an old UpgradeBee will '''never''' have a newer version of the script. You '''may''' be offered a new UpgradeBee when you rez an old one, but it depends on how old the older UpgradeBee is.<br />
<br />
==== For CasperLet ====<br />
----<br />
:* Rez the UpgradeBee<br />
:* Touch/click it<br />
:* Select "Upgrade" <br />
:* Wait until it finishes<br />
<br />
==== For Your Vendors ====<br />
----<br />
:* Rez the UpgradeBee<br />
:* Touch it<br />
:* Click "Update All"<br />
:* Wait until it finishes.<br />
<br />
==== For Vendors Going To Your Affiliates ====<br />
----<br />
For Affiliate vendors, you can do one of the following:<br />
<br />
:# Rez each of your affiliate vendors<br />
:# Use the UpgradeBee<br />
:# Pick them up <br />
:# Ship them out<br />
<br />
: '''Or....'''<br />
<br />
:# Send the UpgradeBee to each of your affiliates<br />
<br />
The first method is actually the '''recommended''' way, even though it's more of a hassle for you, the merchant. <br />
<br />
There's four big reasons why just sending the UpgradeBee to your affiliates isn't effective: <br />
:# Affiliates simply don't bother to update<br />
:# If you ship vendors as no-modify, it won't work anyway<br />
:# If they "lock" their vendors, it won't work anyway<br />
:# If you never update your original pack, you'll still be shipping out OLD vendors in the future. <br />
<br />
You always need the '''CURRENT''' UpgradeBee to upgrade vendors to the current version. Packing an old UpgradeBee in the box with affiliate vendors will not upgrade vendors to a newer version of the script than what the UpgradeBee has.<br />
<br />
= '''<span style="color:#00528c">Does My Product Use the UpgradeBee?</span>''' =<br />
<br />
==== These Products Use An UpgradeBee ====<br />
----<br />
* Affiliate expansion<br />
* CasperLet <br />
* CasperVend (both free and premium)<br />
* Holovend expansion<br />
* Lucky Chairs expansion<br />
* Mesh Expansion<br />
* Texture Vendors expansion<br />
<br />
==== These products do NOT ====<br />
----<br />
* Gift Cards<br />
* Let It Snow<br />
* Resizer<br />
* Rez-Free / Rez-Free Premium<br />
* SimpleSit<br />
* Spinner<br />
* Titler of Doom<br />
* Transporter<br />
* CasperUpdate<br />
<br />
= '''<span style="color:#00528c">Do I Have to Upgrade?</span>''' =<br />
Upgrades are rarely mandatory, but often recommended for bug fixes. <br />
<br />
DropBox upgrades are generally to work around delivery issue bugs that the Lab has introduced since the prior version. While these are not technically mandatory, please consider them as such, because the older versions often won't '''reliably''' deliver your items anymore. <br />
<br />
When we do force a major upgrade (such as the decomissioning of the v1 network in favor of the v2's), we give several months of notice so you have plenty of opportunity to upgrade the affected CasperTech product.<br />
<br />
= '''<span style="color:#00528c">What Do I Do If My Product Isn't Bee-Upgradable?</span>''' =<br />
If there's no updatebee for your product, you will need to set up any new versions manually that you want to use since there's no automated upgrade process.<br />
<br />
= '''<span style="color:#00528c">Not the "update" information you were looking for?</span>''' =<br />
If you were looking for how to send updated versions of products to customers via CasperVend, see the [[CasperVend_2/Updates | product updates]] page instead.<br />
<br />
= '''<span style="color:#00528c">FAQ / Troubleshooting</span>''' =<br />
<br />
: '''Q. Will the UgradeBee update vendors in all sims/regions I have vendors in or just one?''' <br />
<br />
:: '''A1.''' The UpgradeBee can only update vendors in one sim at a time - unfortunately the commands are not able to cross sim boundaries or go across the grid. Because updating the script requires a reset, you'll need to be present ''at some point'' (it can be "now" or "later") to answer all the yellow/orange debit permissions windows. Remember that your vendors will NOT function for your customers until you grant these debit permissions!<br />
<br />
:: This happens because the new updated script does NOT know - will never know - the permissions you granted to the old version. To you, this is "granting them again" but to the script this is "I never had permissions, so I have to ask." <br />
<br />
:: '''A2.''' If you have multiple locations, you can drop an upgrade bee at each one, start it going at each location, and then come back around later to answer all the debit permissions requests. Just remember that vendors won't work until debit permissions are granted, so don't leave them hanging too long if you can avoid it. <br />
<br />
: '''Q. When I rez out a vendor from inventory, should it always ask for debit permissions? ''' <br />
<br />
:: '''A.''' If you have PREVIOUSLY granted debit permissions, and then picked it up, or picked up a copy, then no, it will not ask again - it remembers debit permissions once granted, as long as it has not been updated or hard reset. <br />
<br />
: '''Q. When I use an updatebee, I have to manually grant debit permission for each vendor. I thought the vendors remembered this? '''<br />
<br />
:: '''A1.''' This happens because the new updated script does NOT know the permissions you granted to the old version. To you, this is "granting them again" but to the script this is "I never had permissions, so I have to ask."<br />
<br />
:: '''A2.''' This also happens if you drag-copy - the copy will ask for debit permissions, but the original will remember them. <br />
<br />
:: '''A3.''' If you manually reset (a/k/a hard reset) the vendors, it will act as a brand new script (because resetting scripts makes them flush their prior memory, which includes debit permissions.)<br />
<br />
: '''Q. If I update a product but keep the new name the same as the old one, can I just delete the old box from the dropbox, add the new, and not worry about relisting? '''<br />
<br />
:: '''A.''' Yes, as long as the name really is an exact match between the two.<br />
<br />
: '''Q. I ran the update, and it completed successfully, but the box / vendor / rental unit still says the old version number'''<br />
<br />
:: '''A.''' The updating process only replaces the *script* - it does not rename the object that the script is in. If you want the object's version number to match the version of the script, you'll need to replace it yourself.</div>24607dde-d704-4db7-afa0-d9edc17c926chttps://wiki.casperdns.com/index.php?title=Updating&diff=15343Updating2023-10-14T16:29:52Z<p>24607dde-d704-4db7-afa0-d9edc17c926c: /* CasperVend 2.x */</p>
<hr />
<div>{|align=right<br />
|__TOC__<br />
|}<br />
[[File:German_flag.gif]] [[CasperVend_2/Updating/DE | Schaue hier in Deutsch!]]<br />
= '''<span style="color:#00528c">Upgrading From CasperVend Free To Premium OR FatPack</span>''' =<br />
If you're currently using CasperVend Free, you can upgrade to CasperVend Premium really easily! <br />
<br />
The steps are simple: <br />
# Rez out the Premium or FatPack shipping crate on land where you can run scripts.<br />
# Click the shipping crate.<br />
# You can accept or decline the folder it gives you, it doesn't matter which you do.<br />
# Wait for the shipping crate to disappear.<br />
<br />
There is NO need to replace existing vendors or dropboxes, or to even run an UpgradeBee! The web server will be notified that you have purchased the upgrade, and they should stop taking the 5% commission automatically.<br />
<br />
= '''<span style="color:#00528c">How to Get the Latest Version</span>''' =<br />
There are many ways to get the latest versions of your CasperTech products:<br />
<br />
Check the '''[[Current_Versions | Current Versions]]''' to see what the latest version is and compare it against the one you have. <br />
<br />
==== Use a Redelivery Terminal ====<br />
----<br />
ANY CasperVend redelivery terminal (it's bundled with CasperVend), ANYWHERE on the grid can be used to get the updated version of any CasperTech product. It doesn't matter whether it's your terminal, Casper's terminal, or someone else's. <br />
<br />
However, if you use the one at the '''[https://maps.secondlife.com/secondlife/Caspertech/184/85/134 CasperTech store]''', it will sort all CasperTech purchases to the top of the list, making them much easier to find on the webpage.<br />
<br />
==== Use a Vendor ====<br />
----<br />
Touch the main panel of any CasperVend v2 vendor, and on the popup menu, use the "Redeliver" button to access our redelivery system.<br />
<br />
==== Visit the Overview tab on the CasperVend Website ====<br />
----<br />
All your purchases are listed on the CasperVend website on the overview tab for you to redeliver.<br />
<br />
==== Send "CasperTech Resident" an IM ====<br />
----<br />
You'll receive an automatic response within a minute or two which will guide you to getting your product update.<br />
<br />
==== Rez an older v2 version ====<br />
----<br />
Simply rez out a fresh copy of an older version from your inventory and you will be asked if you want an UpgradeBee to update the units. This applies to vendors, dropboxes, and rental units.<br />
<br />
= '''<span style="color:#00528c">Upgrading From Premium To Fatpack</span>''' =<br />
If you purchased the Premium pack within the last three (3) days, contact Casper Warden directly (via inworld IM, '''not''' by notecard - his notecards cap and he'll never see your notecard) to make arrangements for paying the difference and upgrading to the fatpack. After three days, you will need to buy the expansions separately.<br />
<br />
= '''<span style="color:#00528c">How to Update</span>''' =<br />
<br />
<br />
{{Information|The UpgradeBee will replace the old script with the new version, but does NOT change the name of the containing prim. You will have to rename the prim if you want it to reflect the new version. Popup/Touch menus always reflect the '''object name''' not the script version.}}<br />
<br />
=== CasperVend 2.x ===<br />
----<br />
Updating the CasperVend 2.x line is much easier - no need to replace your vendors, just let the UpgradeBee do all the work while you relax! (However, you '''will''' need to repeat this process in '''each''' sim/region that you have vendors.) <br />
<br />
:# Get the latest version of the CasperVend crate from a redelivery terminal (such as the ones at [https://maps.secondlife.com/secondlife/Caspertech/184/85/134 CasperTech])<br />
:# Unpack the UpgradeBee from the shipping crate<br />
:# Rez or wear/add (recommended) the UpgradeBee<br />
:# Click "Upgrade"<br />
:# Answer the orange debit perm windows <br />
:# When all the vendors are upgraded, the UpgradeBee will return to you<br />
:# All done - you may safely delete the Bee once it appears over your head<br />
<br />
=== CasperLet 1.x ===<br />
----<br />
CasperLet upgrades are simple<br />
:# Get the latest version of the CasperLet crate from a redelivery terminal (Such as the ones at [https://maps.secondlife.com/secondlife/Caspertech/184/85/134 CasperTech])<br />
:# Unpack the UpgradeBee from the shipping crate ("3) UpgradeBee CASPERLET ONLY vX.XX")<br />
:# Rez or wear/add (recommended) the UpgradeBee<br />
:# Click "Upgrade"<br />
:# Answer the orange debit perm windows <br />
:# When all the rental units are upgraded, the UpgradeBee will return to you<br />
:# All done - you may safely delete the Bee once it appears over your head<br />
:# Repeat on ALL sims where you have rental units<br />
<br />
If some of your units do not update correctly, please TOUCH them, choose Reset, wait a few moments, then run the bee again.<br />
<br />
=== DropBoxes 2.x ===<br />
----<br />
Updating DropBoxes is easy - no need to replace your DropBoxes, just let the UpgradeBee do all the work while you relax! (However, you '''will''' need to repeat this process in '''each''' sim/region that you have DropBoxes. You can check WHERE you have DropBoxes rezzed by visiting https://caspervend.casperdns.com/dropboxes.php ) <br />
<br />
:# Get the latest version of CasperVend, CasperLet or CasperUpdate from a redelivery terminal (such as the ones at [https://maps.secondlife.com/secondlife/Caspertech/184/85/134 CasperTech])<br />
:# Unpack the UpgradeBee DROPBOXES ONLY from the shipping crate<br />
:# Rez or wear/add (recommended) the UpgradeBee <br />
:# Click - Pop-Up - "Run Update"<br />
:# Grant debit permissions (since v2.70)<br />
:# When all the DropBoxes are upgraded, the UpgradeBee will return to you (if rezzed). You will get notified in local chat, whether rezzed or worn<br />
:# All done - you may safely delete or detach the Bee once it appears over your head<br />
<br />
=== CasperSafe ===<br />
----<br />
CasperSafe upgrades are simple<br />
<br />
:# Get the latest version of the CasperSafe crate from a redelivery terminal (such as the ones at [https://maps.secondlife.com/secondlife/Caspertech/184/85/134 CasperTech])<br />
:# Unpack the UpgradeBee from the shipping crate ("CasperSafe UpgradeBee x.xx")<br />
:# Rez the UpgradeBee <br />
:# Click the bee<br />
:# Click "UPDATE NOW"<br />
:# When all the orbs are updated, the UpgradeBee will return to its previous position<br />
:# All done - you may safely delete the Bee once it returns.<br />
:# Repeat on ALL sims where you have CasperSafe orbs<br />
<br />
<br />
=== Vendors / Dropboxes / Rental units gone to sleep? ===<br />
----<br />
:# Click the vendor / dropbox / rental unit<br />
:# Click "reset" or "resync" on the popup menu as appropriate<br />
:# Repeat with all units that have gone to sleep<br />
:# Wait a minute or two<br />
:# Run the UpgradeBee again<br />
<br />
'''VENDORS ONLY:''' If the units are '''really''' stubborn and refuse to update after that, then edit > reset scripts in selection for a hard reset of the unit(s) in question. Then run the UpgradeBee again.<br />
<br />
=== Version 2.08 of vendor script ===<br />
----<br />
This specific version was particularly difficult to upgrade from because it really didn't want to "wake up" from the idling state. <br />
<br />
If you still have any vendors with the 2.08 version of the script, you will likely need to manually replace the script (Right-Click > Edit > "contents" tab, delete the old and replace with the new) or outright replace the vendors.<br />
<br />
= '''<span style="color:#00528c">How Do I Use the UpgradeBee?</span>''' =<br />
You '''will''' have to grant debit perms many times as the vendors and rental units come back online; '''THIS IS NORMAL''' because it is replacing the script (and the new script doesn't know about the permissions you gave the old script). If you don't answer them right away, they '''will''' pile up because the vendors will keep asking for them every minute or two. Please make sure it's the latest UpgradeBee, from the latest pack, of the product you want to update. Note that the CasperVend FatPack consists of many products, each with their own UpgradeBee.<br />
<br />
You will also need to do this in EACH sim/region that you have upgradeable products rezzed in. <br />
<br />
=== Always Use the Latest Bee ===<br />
----<br />
The UpgradeBee always ships with two scripts: <br />
:# The Bee script that controls the upgrade process<br />
:# The then-current version of the script it is designed to upgrade<br />
<br />
It will only use the script in its inventory, so an old UpgradeBee will '''never''' have a newer version of the script. You '''may''' be offered a new UpgradeBee when you rez an old one, but it depends on how old the older UpgradeBee is.<br />
<br />
==== For CasperLet ====<br />
----<br />
:* Rez the UpgradeBee<br />
:* Touch/click it<br />
:* Select "Upgrade" <br />
:* Wait until it finishes<br />
<br />
==== For Your Vendors ====<br />
----<br />
:* Rez the UpgradeBee<br />
:* Touch it<br />
:* Click "Update All"<br />
:* Wait until it finishes.<br />
<br />
==== For Vendors Going To Your Affiliates ====<br />
----<br />
For Affiliate vendors, you can do one of the following:<br />
<br />
:# Rez each of your affiliate vendors<br />
:# Use the UpgradeBee<br />
:# Pick them up <br />
:# Ship them out<br />
<br />
: '''Or....'''<br />
<br />
:# Send the UpgradeBee to each of your affiliates<br />
<br />
The first method is actually the '''recommended''' way, even though it's more of a hassle for you, the merchant. <br />
<br />
There's four big reasons why just sending the UpgradeBee to your affiliates isn't effective: <br />
:# Affiliates simply don't bother to update<br />
:# If you ship vendors as no-modify, it won't work anyway<br />
:# If they "lock" their vendors, it won't work anyway<br />
:# If you never update your original pack, you'll still be shipping out OLD vendors in the future. <br />
<br />
You always need the '''CURRENT''' UpgradeBee to upgrade vendors to the current version. Packing an old UpgradeBee in the box with affiliate vendors will not upgrade vendors to a newer version of the script than what the UpgradeBee has.<br />
<br />
= '''<span style="color:#00528c">Does My Product Use the UpgradeBee?</span>''' =<br />
<br />
==== These Products Use An UpgradeBee ====<br />
----<br />
* Affiliate expansion<br />
* CasperLet <br />
* CasperVend (both free and premium)<br />
* Holovend expansion<br />
* Lucky Chairs expansion<br />
* Mesh Expansion<br />
* Texture Vendors expansion<br />
<br />
==== These products do NOT ====<br />
----<br />
* Gift Cards<br />
* Let It Snow<br />
* Resizer<br />
* Rez-Free / Rez-Free Premium<br />
* SimpleSit<br />
* Spinner<br />
* Titler of Doom<br />
* Transporter<br />
* CasperUpdate<br />
<br />
= '''<span style="color:#00528c">Do I Have to Upgrade?</span>''' =<br />
Upgrades are rarely mandatory, but often recommended for bug fixes. <br />
<br />
DropBox upgrades are generally to work around delivery issue bugs that the Lab has introduced since the prior version. While these are not technically mandatory, please consider them as such, because the older versions often won't '''reliably''' deliver your items anymore. <br />
<br />
When we do force a major upgrade (such as the decomissioning of the v1 network in favor of the v2's), we give several months of notice so you have plenty of opportunity to upgrade the affected CasperTech product.<br />
<br />
= '''<span style="color:#00528c">What Do I Do If My Product Isn't Bee-Upgradable?</span>''' =<br />
If there's no updatebee for your product, you will need to set up any new versions manually that you want to use since there's no automated upgrade process.<br />
<br />
= '''<span style="color:#00528c">Not the "update" information you were looking for?</span>''' =<br />
If you were looking for how to send updated versions of products to customers via CasperVend, see the [[CasperVend_2/Updates | product updates]] page instead.<br />
<br />
= '''<span style="color:#00528c">FAQ / Troubleshooting</span>''' =<br />
<br />
: '''Q. Will the UgradeBee update vendors in all sims/regions I have vendors in or just one?''' <br />
<br />
:: '''A1.''' The UpgradeBee can only update vendors in one sim at a time - unfortunately the commands are not able to cross sim boundaries or go across the grid. Because updating the script requires a reset, you'll need to be present ''at some point'' (it can be "now" or "later") to answer all the yellow/orange debit permissions windows. Remember that your vendors will NOT function for your customers until you grant these debit permissions!<br />
<br />
:: This happens because the new updated script does NOT know - will never know - the permissions you granted to the old version. To you, this is "granting them again" but to the script this is "I never had permissions, so I have to ask." <br />
<br />
:: '''A2.''' If you have multiple locations, you can drop an upgrade bee at each one, start it going at each location, and then come back around later to answer all the debit permissions requests. Just remember that vendors won't work until debit permissions are granted, so don't leave them hanging too long if you can avoid it. <br />
<br />
: '''Q. When I rez out a vendor from inventory, should it always ask for debit permissions? ''' <br />
<br />
:: '''A.''' If you have PREVIOUSLY granted debit permissions, and then picked it up, or picked up a copy, then no, it will not ask again - it remembers debit permissions once granted, as long as it has not been updated or hard reset. <br />
<br />
: '''Q. When I use an updatebee, I have to manually grant debit permission for each vendor. I thought the vendors remembered this? '''<br />
<br />
:: '''A1.''' This happens because the new updated script does NOT know the permissions you granted to the old version. To you, this is "granting them again" but to the script this is "I never had permissions, so I have to ask."<br />
<br />
:: '''A2.''' This also happens if you drag-copy - the copy will ask for debit permissions, but the original will remember them. <br />
<br />
:: '''A3.''' If you manually reset (a/k/a hard reset) the vendors, it will act as a brand new script (because resetting scripts makes them flush their prior memory, which includes debit permissions.)<br />
<br />
: '''Q. If I update a product but keep the new name the same as the old one, can I just delete the old box from the dropbox, add the new, and not worry about relisting? '''<br />
<br />
:: '''A.''' Yes, as long as the name really is an exact match between the two.<br />
<br />
: '''Q. I ran the update, and it completed successfully, but the box / vendor / rental unit still says the old version number'''<br />
<br />
:: '''A.''' The updating process only replaces the *script* - it does not rename the object that the script is in. If you want the object's version number to match the version of the script, you'll need to replace it yourself.</div>24607dde-d704-4db7-afa0-d9edc17c926chttps://wiki.casperdns.com/index.php?title=Updating&diff=15342Updating2023-10-14T16:29:40Z<p>24607dde-d704-4db7-afa0-d9edc17c926c: /* CasperLet 1.x */</p>
<hr />
<div>{|align=right<br />
|__TOC__<br />
|}<br />
[[File:German_flag.gif]] [[CasperVend_2/Updating/DE | Schaue hier in Deutsch!]]<br />
= '''<span style="color:#00528c">Upgrading From CasperVend Free To Premium OR FatPack</span>''' =<br />
If you're currently using CasperVend Free, you can upgrade to CasperVend Premium really easily! <br />
<br />
The steps are simple: <br />
# Rez out the Premium or FatPack shipping crate on land where you can run scripts.<br />
# Click the shipping crate.<br />
# You can accept or decline the folder it gives you, it doesn't matter which you do.<br />
# Wait for the shipping crate to disappear.<br />
<br />
There is NO need to replace existing vendors or dropboxes, or to even run an UpgradeBee! The web server will be notified that you have purchased the upgrade, and they should stop taking the 5% commission automatically.<br />
<br />
= '''<span style="color:#00528c">How to Get the Latest Version</span>''' =<br />
There are many ways to get the latest versions of your CasperTech products:<br />
<br />
Check the '''[[Current_Versions | Current Versions]]''' to see what the latest version is and compare it against the one you have. <br />
<br />
==== Use a Redelivery Terminal ====<br />
----<br />
ANY CasperVend redelivery terminal (it's bundled with CasperVend), ANYWHERE on the grid can be used to get the updated version of any CasperTech product. It doesn't matter whether it's your terminal, Casper's terminal, or someone else's. <br />
<br />
However, if you use the one at the '''[https://maps.secondlife.com/secondlife/Caspertech/184/85/134 CasperTech store]''', it will sort all CasperTech purchases to the top of the list, making them much easier to find on the webpage.<br />
<br />
==== Use a Vendor ====<br />
----<br />
Touch the main panel of any CasperVend v2 vendor, and on the popup menu, use the "Redeliver" button to access our redelivery system.<br />
<br />
==== Visit the Overview tab on the CasperVend Website ====<br />
----<br />
All your purchases are listed on the CasperVend website on the overview tab for you to redeliver.<br />
<br />
==== Send "CasperTech Resident" an IM ====<br />
----<br />
You'll receive an automatic response within a minute or two which will guide you to getting your product update.<br />
<br />
==== Rez an older v2 version ====<br />
----<br />
Simply rez out a fresh copy of an older version from your inventory and you will be asked if you want an UpgradeBee to update the units. This applies to vendors, dropboxes, and rental units.<br />
<br />
= '''<span style="color:#00528c">Upgrading From Premium To Fatpack</span>''' =<br />
If you purchased the Premium pack within the last three (3) days, contact Casper Warden directly (via inworld IM, '''not''' by notecard - his notecards cap and he'll never see your notecard) to make arrangements for paying the difference and upgrading to the fatpack. After three days, you will need to buy the expansions separately.<br />
<br />
= '''<span style="color:#00528c">How to Update</span>''' =<br />
<br />
<br />
{{Information|The UpgradeBee will replace the old script with the new version, but does NOT change the name of the containing prim. You will have to rename the prim if you want it to reflect the new version. Popup/Touch menus always reflect the '''object name''' not the script version.}}<br />
<br />
=== CasperVend 2.x ===<br />
----<br />
Updating the CasperVend 2.x line is much easier - no need to replace your vendors, just let the UpgradeBee do all the work while you relax! (However, you '''will''' need to repeat this process in '''each''' sim/region that you have vendors.) <br />
<br />
:# Get the latest version of the CasperVend crate from a redelivery terminal (such as the ones at [https://maps.secondlife.com/secondlife/Caspertech/184/85/134 CasperTech])<br />
:# Unpack the UpgradeBee from the shipping crate<br />
:# Rez the UpgradeBee <br />
:# Click "Upgrade"<br />
:# Answer the orange debit perm windows <br />
:# When all the vendors are upgraded, the UpgradeBee will return to you<br />
:# All done - you may safely delete the Bee once it appears over your head<br />
<br />
=== CasperLet 1.x ===<br />
----<br />
CasperLet upgrades are simple<br />
:# Get the latest version of the CasperLet crate from a redelivery terminal (Such as the ones at [https://maps.secondlife.com/secondlife/Caspertech/184/85/134 CasperTech])<br />
:# Unpack the UpgradeBee from the shipping crate ("3) UpgradeBee CASPERLET ONLY vX.XX")<br />
:# Rez or wear/add (recommended) the UpgradeBee<br />
:# Click "Upgrade"<br />
:# Answer the orange debit perm windows <br />
:# When all the rental units are upgraded, the UpgradeBee will return to you<br />
:# All done - you may safely delete the Bee once it appears over your head<br />
:# Repeat on ALL sims where you have rental units<br />
<br />
If some of your units do not update correctly, please TOUCH them, choose Reset, wait a few moments, then run the bee again.<br />
<br />
=== DropBoxes 2.x ===<br />
----<br />
Updating DropBoxes is easy - no need to replace your DropBoxes, just let the UpgradeBee do all the work while you relax! (However, you '''will''' need to repeat this process in '''each''' sim/region that you have DropBoxes. You can check WHERE you have DropBoxes rezzed by visiting https://caspervend.casperdns.com/dropboxes.php ) <br />
<br />
:# Get the latest version of CasperVend, CasperLet or CasperUpdate from a redelivery terminal (such as the ones at [https://maps.secondlife.com/secondlife/Caspertech/184/85/134 CasperTech])<br />
:# Unpack the UpgradeBee DROPBOXES ONLY from the shipping crate<br />
:# Rez or wear/add (recommended) the UpgradeBee <br />
:# Click - Pop-Up - "Run Update"<br />
:# Grant debit permissions (since v2.70)<br />
:# When all the DropBoxes are upgraded, the UpgradeBee will return to you (if rezzed). You will get notified in local chat, whether rezzed or worn<br />
:# All done - you may safely delete or detach the Bee once it appears over your head<br />
<br />
=== CasperSafe ===<br />
----<br />
CasperSafe upgrades are simple<br />
<br />
:# Get the latest version of the CasperSafe crate from a redelivery terminal (such as the ones at [https://maps.secondlife.com/secondlife/Caspertech/184/85/134 CasperTech])<br />
:# Unpack the UpgradeBee from the shipping crate ("CasperSafe UpgradeBee x.xx")<br />
:# Rez the UpgradeBee <br />
:# Click the bee<br />
:# Click "UPDATE NOW"<br />
:# When all the orbs are updated, the UpgradeBee will return to its previous position<br />
:# All done - you may safely delete the Bee once it returns.<br />
:# Repeat on ALL sims where you have CasperSafe orbs<br />
<br />
<br />
=== Vendors / Dropboxes / Rental units gone to sleep? ===<br />
----<br />
:# Click the vendor / dropbox / rental unit<br />
:# Click "reset" or "resync" on the popup menu as appropriate<br />
:# Repeat with all units that have gone to sleep<br />
:# Wait a minute or two<br />
:# Run the UpgradeBee again<br />
<br />
'''VENDORS ONLY:''' If the units are '''really''' stubborn and refuse to update after that, then edit > reset scripts in selection for a hard reset of the unit(s) in question. Then run the UpgradeBee again.<br />
<br />
=== Version 2.08 of vendor script ===<br />
----<br />
This specific version was particularly difficult to upgrade from because it really didn't want to "wake up" from the idling state. <br />
<br />
If you still have any vendors with the 2.08 version of the script, you will likely need to manually replace the script (Right-Click > Edit > "contents" tab, delete the old and replace with the new) or outright replace the vendors.<br />
<br />
= '''<span style="color:#00528c">How Do I Use the UpgradeBee?</span>''' =<br />
You '''will''' have to grant debit perms many times as the vendors and rental units come back online; '''THIS IS NORMAL''' because it is replacing the script (and the new script doesn't know about the permissions you gave the old script). If you don't answer them right away, they '''will''' pile up because the vendors will keep asking for them every minute or two. Please make sure it's the latest UpgradeBee, from the latest pack, of the product you want to update. Note that the CasperVend FatPack consists of many products, each with their own UpgradeBee.<br />
<br />
You will also need to do this in EACH sim/region that you have upgradeable products rezzed in. <br />
<br />
=== Always Use the Latest Bee ===<br />
----<br />
The UpgradeBee always ships with two scripts: <br />
:# The Bee script that controls the upgrade process<br />
:# The then-current version of the script it is designed to upgrade<br />
<br />
It will only use the script in its inventory, so an old UpgradeBee will '''never''' have a newer version of the script. You '''may''' be offered a new UpgradeBee when you rez an old one, but it depends on how old the older UpgradeBee is.<br />
<br />
==== For CasperLet ====<br />
----<br />
:* Rez the UpgradeBee<br />
:* Touch/click it<br />
:* Select "Upgrade" <br />
:* Wait until it finishes<br />
<br />
==== For Your Vendors ====<br />
----<br />
:* Rez the UpgradeBee<br />
:* Touch it<br />
:* Click "Update All"<br />
:* Wait until it finishes.<br />
<br />
==== For Vendors Going To Your Affiliates ====<br />
----<br />
For Affiliate vendors, you can do one of the following:<br />
<br />
:# Rez each of your affiliate vendors<br />
:# Use the UpgradeBee<br />
:# Pick them up <br />
:# Ship them out<br />
<br />
: '''Or....'''<br />
<br />
:# Send the UpgradeBee to each of your affiliates<br />
<br />
The first method is actually the '''recommended''' way, even though it's more of a hassle for you, the merchant. <br />
<br />
There's four big reasons why just sending the UpgradeBee to your affiliates isn't effective: <br />
:# Affiliates simply don't bother to update<br />
:# If you ship vendors as no-modify, it won't work anyway<br />
:# If they "lock" their vendors, it won't work anyway<br />
:# If you never update your original pack, you'll still be shipping out OLD vendors in the future. <br />
<br />
You always need the '''CURRENT''' UpgradeBee to upgrade vendors to the current version. Packing an old UpgradeBee in the box with affiliate vendors will not upgrade vendors to a newer version of the script than what the UpgradeBee has.<br />
<br />
= '''<span style="color:#00528c">Does My Product Use the UpgradeBee?</span>''' =<br />
<br />
==== These Products Use An UpgradeBee ====<br />
----<br />
* Affiliate expansion<br />
* CasperLet <br />
* CasperVend (both free and premium)<br />
* Holovend expansion<br />
* Lucky Chairs expansion<br />
* Mesh Expansion<br />
* Texture Vendors expansion<br />
<br />
==== These products do NOT ====<br />
----<br />
* Gift Cards<br />
* Let It Snow<br />
* Resizer<br />
* Rez-Free / Rez-Free Premium<br />
* SimpleSit<br />
* Spinner<br />
* Titler of Doom<br />
* Transporter<br />
* CasperUpdate<br />
<br />
= '''<span style="color:#00528c">Do I Have to Upgrade?</span>''' =<br />
Upgrades are rarely mandatory, but often recommended for bug fixes. <br />
<br />
DropBox upgrades are generally to work around delivery issue bugs that the Lab has introduced since the prior version. While these are not technically mandatory, please consider them as such, because the older versions often won't '''reliably''' deliver your items anymore. <br />
<br />
When we do force a major upgrade (such as the decomissioning of the v1 network in favor of the v2's), we give several months of notice so you have plenty of opportunity to upgrade the affected CasperTech product.<br />
<br />
= '''<span style="color:#00528c">What Do I Do If My Product Isn't Bee-Upgradable?</span>''' =<br />
If there's no updatebee for your product, you will need to set up any new versions manually that you want to use since there's no automated upgrade process.<br />
<br />
= '''<span style="color:#00528c">Not the "update" information you were looking for?</span>''' =<br />
If you were looking for how to send updated versions of products to customers via CasperVend, see the [[CasperVend_2/Updates | product updates]] page instead.<br />
<br />
= '''<span style="color:#00528c">FAQ / Troubleshooting</span>''' =<br />
<br />
: '''Q. Will the UgradeBee update vendors in all sims/regions I have vendors in or just one?''' <br />
<br />
:: '''A1.''' The UpgradeBee can only update vendors in one sim at a time - unfortunately the commands are not able to cross sim boundaries or go across the grid. Because updating the script requires a reset, you'll need to be present ''at some point'' (it can be "now" or "later") to answer all the yellow/orange debit permissions windows. Remember that your vendors will NOT function for your customers until you grant these debit permissions!<br />
<br />
:: This happens because the new updated script does NOT know - will never know - the permissions you granted to the old version. To you, this is "granting them again" but to the script this is "I never had permissions, so I have to ask." <br />
<br />
:: '''A2.''' If you have multiple locations, you can drop an upgrade bee at each one, start it going at each location, and then come back around later to answer all the debit permissions requests. Just remember that vendors won't work until debit permissions are granted, so don't leave them hanging too long if you can avoid it. <br />
<br />
: '''Q. When I rez out a vendor from inventory, should it always ask for debit permissions? ''' <br />
<br />
:: '''A.''' If you have PREVIOUSLY granted debit permissions, and then picked it up, or picked up a copy, then no, it will not ask again - it remembers debit permissions once granted, as long as it has not been updated or hard reset. <br />
<br />
: '''Q. When I use an updatebee, I have to manually grant debit permission for each vendor. I thought the vendors remembered this? '''<br />
<br />
:: '''A1.''' This happens because the new updated script does NOT know the permissions you granted to the old version. To you, this is "granting them again" but to the script this is "I never had permissions, so I have to ask."<br />
<br />
:: '''A2.''' This also happens if you drag-copy - the copy will ask for debit permissions, but the original will remember them. <br />
<br />
:: '''A3.''' If you manually reset (a/k/a hard reset) the vendors, it will act as a brand new script (because resetting scripts makes them flush their prior memory, which includes debit permissions.)<br />
<br />
: '''Q. If I update a product but keep the new name the same as the old one, can I just delete the old box from the dropbox, add the new, and not worry about relisting? '''<br />
<br />
:: '''A.''' Yes, as long as the name really is an exact match between the two.<br />
<br />
: '''Q. I ran the update, and it completed successfully, but the box / vendor / rental unit still says the old version number'''<br />
<br />
:: '''A.''' The updating process only replaces the *script* - it does not rename the object that the script is in. If you want the object's version number to match the version of the script, you'll need to replace it yourself.</div>24607dde-d704-4db7-afa0-d9edc17c926chttps://wiki.casperdns.com/index.php?title=Updating&diff=15341Updating2023-10-14T16:28:47Z<p>24607dde-d704-4db7-afa0-d9edc17c926c: /* DropBoxes 2.x */</p>
<hr />
<div>{|align=right<br />
|__TOC__<br />
|}<br />
[[File:German_flag.gif]] [[CasperVend_2/Updating/DE | Schaue hier in Deutsch!]]<br />
= '''<span style="color:#00528c">Upgrading From CasperVend Free To Premium OR FatPack</span>''' =<br />
If you're currently using CasperVend Free, you can upgrade to CasperVend Premium really easily! <br />
<br />
The steps are simple: <br />
# Rez out the Premium or FatPack shipping crate on land where you can run scripts.<br />
# Click the shipping crate.<br />
# You can accept or decline the folder it gives you, it doesn't matter which you do.<br />
# Wait for the shipping crate to disappear.<br />
<br />
There is NO need to replace existing vendors or dropboxes, or to even run an UpgradeBee! The web server will be notified that you have purchased the upgrade, and they should stop taking the 5% commission automatically.<br />
<br />
= '''<span style="color:#00528c">How to Get the Latest Version</span>''' =<br />
There are many ways to get the latest versions of your CasperTech products:<br />
<br />
Check the '''[[Current_Versions | Current Versions]]''' to see what the latest version is and compare it against the one you have. <br />
<br />
==== Use a Redelivery Terminal ====<br />
----<br />
ANY CasperVend redelivery terminal (it's bundled with CasperVend), ANYWHERE on the grid can be used to get the updated version of any CasperTech product. It doesn't matter whether it's your terminal, Casper's terminal, or someone else's. <br />
<br />
However, if you use the one at the '''[https://maps.secondlife.com/secondlife/Caspertech/184/85/134 CasperTech store]''', it will sort all CasperTech purchases to the top of the list, making them much easier to find on the webpage.<br />
<br />
==== Use a Vendor ====<br />
----<br />
Touch the main panel of any CasperVend v2 vendor, and on the popup menu, use the "Redeliver" button to access our redelivery system.<br />
<br />
==== Visit the Overview tab on the CasperVend Website ====<br />
----<br />
All your purchases are listed on the CasperVend website on the overview tab for you to redeliver.<br />
<br />
==== Send "CasperTech Resident" an IM ====<br />
----<br />
You'll receive an automatic response within a minute or two which will guide you to getting your product update.<br />
<br />
==== Rez an older v2 version ====<br />
----<br />
Simply rez out a fresh copy of an older version from your inventory and you will be asked if you want an UpgradeBee to update the units. This applies to vendors, dropboxes, and rental units.<br />
<br />
= '''<span style="color:#00528c">Upgrading From Premium To Fatpack</span>''' =<br />
If you purchased the Premium pack within the last three (3) days, contact Casper Warden directly (via inworld IM, '''not''' by notecard - his notecards cap and he'll never see your notecard) to make arrangements for paying the difference and upgrading to the fatpack. After three days, you will need to buy the expansions separately.<br />
<br />
= '''<span style="color:#00528c">How to Update</span>''' =<br />
<br />
<br />
{{Information|The UpgradeBee will replace the old script with the new version, but does NOT change the name of the containing prim. You will have to rename the prim if you want it to reflect the new version. Popup/Touch menus always reflect the '''object name''' not the script version.}}<br />
<br />
=== CasperVend 2.x ===<br />
----<br />
Updating the CasperVend 2.x line is much easier - no need to replace your vendors, just let the UpgradeBee do all the work while you relax! (However, you '''will''' need to repeat this process in '''each''' sim/region that you have vendors.) <br />
<br />
:# Get the latest version of the CasperVend crate from a redelivery terminal (such as the ones at [https://maps.secondlife.com/secondlife/Caspertech/184/85/134 CasperTech])<br />
:# Unpack the UpgradeBee from the shipping crate<br />
:# Rez the UpgradeBee <br />
:# Click "Upgrade"<br />
:# Answer the orange debit perm windows <br />
:# When all the vendors are upgraded, the UpgradeBee will return to you<br />
:# All done - you may safely delete the Bee once it appears over your head<br />
<br />
=== CasperLet 1.x ===<br />
----<br />
CasperLet upgrades are simple<br />
:# Get the latest version of the CasperLet crate from a redelivery terminal (Such as the ones at [https://maps.secondlife.com/secondlife/Caspertech/184/85/134 CasperTech])<br />
:# Unpack the UpgradeBee from the shipping crate ("3) UpgradeBee CASPERLET ONLY vX.XX")<br />
:# Rez the UpgradeBee <br />
:# Click "Upgrade"<br />
:# Answer the orange debit perm windows <br />
:# When all the rental units are upgraded, the UpgradeBee will return to you<br />
:# All done - you may safely delete the Bee once it appears over your head<br />
:# Repeat on ALL sims where you have rental units<br />
<br />
If some of your units do not update correctly, please TOUCH them, choose Reset, wait a few moments, then run the bee again.<br />
<br />
=== DropBoxes 2.x ===<br />
----<br />
Updating DropBoxes is easy - no need to replace your DropBoxes, just let the UpgradeBee do all the work while you relax! (However, you '''will''' need to repeat this process in '''each''' sim/region that you have DropBoxes. You can check WHERE you have DropBoxes rezzed by visiting https://caspervend.casperdns.com/dropboxes.php ) <br />
<br />
:# Get the latest version of CasperVend, CasperLet or CasperUpdate from a redelivery terminal (such as the ones at [https://maps.secondlife.com/secondlife/Caspertech/184/85/134 CasperTech])<br />
:# Unpack the UpgradeBee DROPBOXES ONLY from the shipping crate<br />
:# Rez or wear/add (recommended) the UpgradeBee <br />
:# Click - Pop-Up - "Run Update"<br />
:# Grant debit permissions (since v2.70)<br />
:# When all the DropBoxes are upgraded, the UpgradeBee will return to you (if rezzed). You will get notified in local chat, whether rezzed or worn<br />
:# All done - you may safely delete or detach the Bee once it appears over your head<br />
<br />
=== CasperSafe ===<br />
----<br />
CasperSafe upgrades are simple<br />
<br />
:# Get the latest version of the CasperSafe crate from a redelivery terminal (such as the ones at [https://maps.secondlife.com/secondlife/Caspertech/184/85/134 CasperTech])<br />
:# Unpack the UpgradeBee from the shipping crate ("CasperSafe UpgradeBee x.xx")<br />
:# Rez the UpgradeBee <br />
:# Click the bee<br />
:# Click "UPDATE NOW"<br />
:# When all the orbs are updated, the UpgradeBee will return to its previous position<br />
:# All done - you may safely delete the Bee once it returns.<br />
:# Repeat on ALL sims where you have CasperSafe orbs<br />
<br />
<br />
=== Vendors / Dropboxes / Rental units gone to sleep? ===<br />
----<br />
:# Click the vendor / dropbox / rental unit<br />
:# Click "reset" or "resync" on the popup menu as appropriate<br />
:# Repeat with all units that have gone to sleep<br />
:# Wait a minute or two<br />
:# Run the UpgradeBee again<br />
<br />
'''VENDORS ONLY:''' If the units are '''really''' stubborn and refuse to update after that, then edit > reset scripts in selection for a hard reset of the unit(s) in question. Then run the UpgradeBee again.<br />
<br />
=== Version 2.08 of vendor script ===<br />
----<br />
This specific version was particularly difficult to upgrade from because it really didn't want to "wake up" from the idling state. <br />
<br />
If you still have any vendors with the 2.08 version of the script, you will likely need to manually replace the script (Right-Click > Edit > "contents" tab, delete the old and replace with the new) or outright replace the vendors.<br />
<br />
= '''<span style="color:#00528c">How Do I Use the UpgradeBee?</span>''' =<br />
You '''will''' have to grant debit perms many times as the vendors and rental units come back online; '''THIS IS NORMAL''' because it is replacing the script (and the new script doesn't know about the permissions you gave the old script). If you don't answer them right away, they '''will''' pile up because the vendors will keep asking for them every minute or two. Please make sure it's the latest UpgradeBee, from the latest pack, of the product you want to update. Note that the CasperVend FatPack consists of many products, each with their own UpgradeBee.<br />
<br />
You will also need to do this in EACH sim/region that you have upgradeable products rezzed in. <br />
<br />
=== Always Use the Latest Bee ===<br />
----<br />
The UpgradeBee always ships with two scripts: <br />
:# The Bee script that controls the upgrade process<br />
:# The then-current version of the script it is designed to upgrade<br />
<br />
It will only use the script in its inventory, so an old UpgradeBee will '''never''' have a newer version of the script. You '''may''' be offered a new UpgradeBee when you rez an old one, but it depends on how old the older UpgradeBee is.<br />
<br />
==== For CasperLet ====<br />
----<br />
:* Rez the UpgradeBee<br />
:* Touch/click it<br />
:* Select "Upgrade" <br />
:* Wait until it finishes<br />
<br />
==== For Your Vendors ====<br />
----<br />
:* Rez the UpgradeBee<br />
:* Touch it<br />
:* Click "Update All"<br />
:* Wait until it finishes.<br />
<br />
==== For Vendors Going To Your Affiliates ====<br />
----<br />
For Affiliate vendors, you can do one of the following:<br />
<br />
:# Rez each of your affiliate vendors<br />
:# Use the UpgradeBee<br />
:# Pick them up <br />
:# Ship them out<br />
<br />
: '''Or....'''<br />
<br />
:# Send the UpgradeBee to each of your affiliates<br />
<br />
The first method is actually the '''recommended''' way, even though it's more of a hassle for you, the merchant. <br />
<br />
There's four big reasons why just sending the UpgradeBee to your affiliates isn't effective: <br />
:# Affiliates simply don't bother to update<br />
:# If you ship vendors as no-modify, it won't work anyway<br />
:# If they "lock" their vendors, it won't work anyway<br />
:# If you never update your original pack, you'll still be shipping out OLD vendors in the future. <br />
<br />
You always need the '''CURRENT''' UpgradeBee to upgrade vendors to the current version. Packing an old UpgradeBee in the box with affiliate vendors will not upgrade vendors to a newer version of the script than what the UpgradeBee has.<br />
<br />
= '''<span style="color:#00528c">Does My Product Use the UpgradeBee?</span>''' =<br />
<br />
==== These Products Use An UpgradeBee ====<br />
----<br />
* Affiliate expansion<br />
* CasperLet <br />
* CasperVend (both free and premium)<br />
* Holovend expansion<br />
* Lucky Chairs expansion<br />
* Mesh Expansion<br />
* Texture Vendors expansion<br />
<br />
==== These products do NOT ====<br />
----<br />
* Gift Cards<br />
* Let It Snow<br />
* Resizer<br />
* Rez-Free / Rez-Free Premium<br />
* SimpleSit<br />
* Spinner<br />
* Titler of Doom<br />
* Transporter<br />
* CasperUpdate<br />
<br />
= '''<span style="color:#00528c">Do I Have to Upgrade?</span>''' =<br />
Upgrades are rarely mandatory, but often recommended for bug fixes. <br />
<br />
DropBox upgrades are generally to work around delivery issue bugs that the Lab has introduced since the prior version. While these are not technically mandatory, please consider them as such, because the older versions often won't '''reliably''' deliver your items anymore. <br />
<br />
When we do force a major upgrade (such as the decomissioning of the v1 network in favor of the v2's), we give several months of notice so you have plenty of opportunity to upgrade the affected CasperTech product.<br />
<br />
= '''<span style="color:#00528c">What Do I Do If My Product Isn't Bee-Upgradable?</span>''' =<br />
If there's no updatebee for your product, you will need to set up any new versions manually that you want to use since there's no automated upgrade process.<br />
<br />
= '''<span style="color:#00528c">Not the "update" information you were looking for?</span>''' =<br />
If you were looking for how to send updated versions of products to customers via CasperVend, see the [[CasperVend_2/Updates | product updates]] page instead.<br />
<br />
= '''<span style="color:#00528c">FAQ / Troubleshooting</span>''' =<br />
<br />
: '''Q. Will the UgradeBee update vendors in all sims/regions I have vendors in or just one?''' <br />
<br />
:: '''A1.''' The UpgradeBee can only update vendors in one sim at a time - unfortunately the commands are not able to cross sim boundaries or go across the grid. Because updating the script requires a reset, you'll need to be present ''at some point'' (it can be "now" or "later") to answer all the yellow/orange debit permissions windows. Remember that your vendors will NOT function for your customers until you grant these debit permissions!<br />
<br />
:: This happens because the new updated script does NOT know - will never know - the permissions you granted to the old version. To you, this is "granting them again" but to the script this is "I never had permissions, so I have to ask." <br />
<br />
:: '''A2.''' If you have multiple locations, you can drop an upgrade bee at each one, start it going at each location, and then come back around later to answer all the debit permissions requests. Just remember that vendors won't work until debit permissions are granted, so don't leave them hanging too long if you can avoid it. <br />
<br />
: '''Q. When I rez out a vendor from inventory, should it always ask for debit permissions? ''' <br />
<br />
:: '''A.''' If you have PREVIOUSLY granted debit permissions, and then picked it up, or picked up a copy, then no, it will not ask again - it remembers debit permissions once granted, as long as it has not been updated or hard reset. <br />
<br />
: '''Q. When I use an updatebee, I have to manually grant debit permission for each vendor. I thought the vendors remembered this? '''<br />
<br />
:: '''A1.''' This happens because the new updated script does NOT know the permissions you granted to the old version. To you, this is "granting them again" but to the script this is "I never had permissions, so I have to ask."<br />
<br />
:: '''A2.''' This also happens if you drag-copy - the copy will ask for debit permissions, but the original will remember them. <br />
<br />
:: '''A3.''' If you manually reset (a/k/a hard reset) the vendors, it will act as a brand new script (because resetting scripts makes them flush their prior memory, which includes debit permissions.)<br />
<br />
: '''Q. If I update a product but keep the new name the same as the old one, can I just delete the old box from the dropbox, add the new, and not worry about relisting? '''<br />
<br />
:: '''A.''' Yes, as long as the name really is an exact match between the two.<br />
<br />
: '''Q. I ran the update, and it completed successfully, but the box / vendor / rental unit still says the old version number'''<br />
<br />
:: '''A.''' The updating process only replaces the *script* - it does not rename the object that the script is in. If you want the object's version number to match the version of the script, you'll need to replace it yourself.</div>24607dde-d704-4db7-afa0-d9edc17c926chttps://wiki.casperdns.com/index.php?title=CasperVend_2/Profiles_and_groups&diff=15339CasperVend 2/Profiles and groups2023-10-14T14:25:09Z<p>24607dde-d704-4db7-afa0-d9edc17c926c: /* Using Discounts or Price Overrides on Profiles For Recurring Sales */</p>
<hr />
<div><!-- Keywords: range, ranges --><br />
{|align=right<br />
|__TOC__<br />
|}<br />
[[File:German_flag.gif]] [[CasperVend 2/Profiles and groups/DE | Schaue hier in Deutsch!]] <br />
= '''<span style="color:#00528c">Introduction</span>''' =<br />
Profiles specify which products show in a vendor, and the default profile shows EVERYTHING (that you haven't excluded via the product options). So, in order to have only certain products showing in a multi-panel vendor, you need to create a profile containing just those products that you want in that vendor. <br />
<br />
Profiles are applied on a per-vendor basis. You can have many vendors out, each with their own profile.<br />
<br />
Profiles of products '''only''' apply to vendors set '''to''' that profile. They are '''not''' profiles of products, regardless of vendor<br />
<br />
Groups are a sub-category of profiles that allow you to group products together within a profile. For example you can set up individual products (such as a tuxedos, gowns shoes, and casual wear) and then group those products into groups (such as "mens formal", "womens formal", "footwear", etc.) and then put one or more groups into a profile (such as adding the "mens formal" and "womens formal" groups into a profile called "formal wear") and point a multi-panel vendor to that profile. <br />
<br />
Profiles can be applied directly to a vendor, but groups '''cannot'''. You must put a group within a profile, and then point the vendor to that profile.<br />
<br />
= '''<span style="color:#00528c">Profiles</span>''' =<br />
<br />
=== Creating a New Profile ===<br />
----<br />
<br />
:# Log in to the website<br />
:# Go to the "profiles" tab<br />
:# Click "Create New"<br />
:# You'll be taken to a screen with two white boxes <br />
:# Select a product from the left white box that you want to show in the vendor, and click the [-->] button. This will add the product to the profile. Repeat with each additional product you want in the profile. <br />
::: ''There is currently no way to select only some of the products. You can only move one, or move them all, nothing in between.''<br />
<br />
When you're done, click "Finish". Your profile is now ready for use!<br />
<br />
{| <br />
| [[File:CasperVend_Profiles.png|200px|thumb|right|Image of profile setup screen. Click to see larger version.]] <br />
|}<br />
<br />
=== New Profile From Vendor's Configuration Page ===<br />
----<br />
If you want to demo different products from different vendors, you need to put those products into a profile for the HoloVend. This can be done via the Caspervend website, the same way you'd put a multi-item vendor into a profile. <br />
<br />
# Click the CasperVend log on the face of the HoloVend.<br />
# You'll be sent a URL in a popup box, and in local chat.<br />
# Use that link to go to the website and log in.<br />
# If you have never used CasperVend before, '''[[CasperVend_2/Password_Reset#Creating_Your_CasperVend_Account | create your account]]''' now.<br />
# If you have '''forgotten''' your password, use the '''[[CasperVend_2/Password_Reset#Resetting_Your_CasperVend_Password | reset instructions.]]'''<br />
# Once you are logged in, you will reach the vendor configuration page.<br />
# Click '''"New Profile"''' next to the "Action" line: <br /> [[file:Vendor-action-newprofile.png|||"New Profile location on vendor config page]]<br />
# On the next screen, give the profile a distinctive name, then click "Next".<br />
# You will arrive at the profile creation page.<br />
# See the '''[[CasperVend_2/Profiles_and_groups | profiles page]]''' for details of how to select products.<br />
# When you are done selecting products for the profile, click "Finish". <br />
# Your vendor will now update to show the products you've selected.<br />
<br />
=== Editing an Existing Profile ===<br />
----<br />
When you want to edit an existing profile, any vendors which are currently set to that profile will be updated to show the current selection of products automatically when you are done. To edit an existing profile, use the following steps: <br />
<br />
:# Access the vendor configuration page, by clicking the (C)asperVend logo in the bottom left hand corner of the vendor.<br />
:# Switch to the "Profiles" tab on the left hand side.<br />
:# Find the profile you wish to edit, and click [Edit] next to it. You'll be taken to a page with two white boxes. <br />
:# Select a product from the left white box that you want to show in the vendor, and click the [-->] button. This will add the product to the profile. Repeat with each additional product you want in the profile. <br />
:: ''There is currently no way to select only several of the products. You can only move one, or move them all, nothing in between.''<br />
:# When you're done, click "Finish". <br />
<br />
=== Using an Existing Profile On Multi-Product Vendors ===<br />
----<br />
For scrolling, multi-product vendors, you need to create a full profile. If you only select a single product on a multi-item vendor, you'll see the same product across all the vendor panels. <br />
<br />
If you have already created a profile, you can assign it to more vendors. This can be convenient because it means if you change the profile in future, all vendors which are set to that profile will also be updated.<br />
<br />
:# Access the vendor configuration page, by clicking the (C)asperVend logo in the bottom left hand corner of the vendor.<br />
:# Look for the configuration option "Profile", and click [Change] next to it.<br />
:# Simply select the profile you want to set to the vendor, then click [Save]. <br />
:# The vendor will then be updated to use your new profile within a couple minutes!<br />
<br />
=== Using a profile on multiple vendors ===<br />
----<br />
The best way to get a profile to "stick" to a vendor - whether one or multiple - is to tell the vendor(s) what profile to use during setup. While you can change the profile later, it will NOT change copies in your SL inventory, object inventory, or marketplace inventory - they can only "hear" the profile change command from the system while they are rezzed inworld.<br />
<br />
As long as the vendor was rezzed inworld to "hear" the profile change command, any future copies of THAT vendor (or vendors) will also use the same new profile. If you have copies of that vendor(s) still in inventory with the old profile, you must delete them and pick up new copies of the vendor(s) with the new profile.<br />
<br />
= '''<span style="color:#00528c">Excluding From Default Profile</span>''' =<br />
As you gain more experience as a merchant, you may find you don't want to have all the products in the "default" (everything) profile. Here's how you can remove existing products from that profile: <br />
<br />
:# Log in to your CasperVend<br />
:# Go to the '''[https://caspervend.casperdns.com/productsNew.php Products]''' tab<br />
:# Show the products you want to exclude from the default<br />
:# Tick the selector boxes on the left of each product (or you can use the "all" button at the top)<br />
:# Scroll down to the bulk updates block <br />
:# Tick the box for "set product options" <br />
:# Tick the option box for "Exclude this product from the default profile"<br />
:# Scroll down and click "Update Selected" <br />
:# Wait for it to process<br />
<br />
All set! <br />
<br />
{| <br />
| [[File:Exclude_from_default.jpg|300px|thumb|left|Arrows pointing to the appropriate options]]<br />
|}<br />
<br />
= '''<span style="color:#00528c">Groups</span>''' =<br />
When you go to create a profile, you can add in individual products, or one (or more) groups, or both. Then a vendor can be pointed to that profile. Groups '''cannot''' be added to a vendor - only single products or a profile. <br />
<br />
=== Creating a New Group ===<br />
----<br />
Because group names will appear in the product list along with your other products, you should give your groups a consistent beginning to the name to sort them to one findable place in the list - you could start the group name with ''"Group - "''' for example. <br />
<br />
:# Log in to the CasperVend website<br />
:# Click "Groups" <br />
:# Click "Create New Group"<br />
:# Enter a name for the new product group in the text box and then click "Create"<br />
:# You will be presented with a pair of white boxes, the left one showing your existing products, and the right one starting off empty. <br />
:# Select the products you want to have in this group. Click to select one product, then click the --> right arrow to move it to the box on the right side. You can only move one at a time, or all of them at once. <br />
:# When you are done, click finish. Your group is complete! <br />
<br />
There is currently no way to select only some of the products. You can only move one, or move them all, nothing in between.<br />
<br />
=== Adding a Group to a Profile ===<br />
----<br />
When you want to add a group to an existing profile, any vendors which are currently set to that profile will be updated to show the current selection of products - including the grouped products - automatically when you are done. To edit an existing profile, use the following steps: <br />
<br />
:# Access the vendor configuration page, by clicking the (C)asperVend logo in the bottom left hand corner of the vendor.<br />
:# Switch to the "Profiles" tab on the left hand side.<br />
:# Find the profile you wish to edit, and click [Edit] next to it. You'll be taken to a page with two white boxes. <br />
:# Select a product from the left white box that you want to show in the vendor, and click the [-->] button. This will add the product to the profile. Repeat with each additional product you want in the profile. <br />
:# When you're done, click "Finish". <br />
<br />
There is currently no way to select only some of the products. You can only move one, or move them all, nothing in between.<br />
<br />
= '''<span style="color:#00528c">Setting Discounts on Profiles</span>''' =<br />
Discounts on profiles will give all customers (not just group members) a discount off the regular price of everything in that profile. (The "regular price" is the price you set in the product listing.) <br />
<br />
'''''Discounts on profiles only apply to the vendor(s) set to SHOW that profile. It is not a profile of products, regardless of what vendor they are shown on.'''''<br />
<br />
:# Log in to the website<br />
:# Go to the "profiles" tab<br />
:# Find the profile you want to offer a discount on, and click "Edit" next to it<br />
:# You'll be taken to the profile screen with the two white boxes<br />
:# Above those two white boxes are three checkboxes<br />
:# Tick the box for "Discount all items in this profile by ____%" and fill in the % discount<br />
:# Click finish<br />
:# All set!<br />
<br />
= '''<span style="color:#00528c">Setting Price Overrides on Profiles</span>''' =<br />
Price overrides on profiles will override the product pricing of '''everything''' in '''that''' profile, regardless of any sale going on at that time, making them all cost the amount you put in the little box. Be absolutely certain you want to do this, especially if you have an expensive build in the profile that you don't want sold at a really cheap price. <br />
<br />
'''''Price overrides on profiles only apply to the vendor(s) set to SHOW that profile. It is not a profile of products, regardless of what vendor they are shown on.'''''<br />
<br />
:# Log in to the website<br />
:# Go to the "profiles" tab<br />
:# Find the profile you want to offer a discount on, and click "Edit" next to it<br />
:# You'll be taken to the profile screen with the two white boxes<br />
:# Above those two white boxes are three checkboxes<br />
:# Tick the box for "Override the price of all products in this profile to L$___" and fill in the override price <br />
:# Click finish<br />
:# All set!<br />
<br />
=== Using Discounts or Price Overrides on Profiles For Recurring Sales===<br />
----<br />
<br />
For weekly / monthly sale events, for which you want to rotate the product(s) on discount / price override, there is a simple method.<br />
This can be applied for single products (in single product vendors set to that profile), or multiple products (in multi-panel vendors set to that profile), and can be beneficial if you have several vendors running that sale (regardless of whether on the same or different regions).<br />
<br />
:# Create the profile, and give it a unique name (eg named as per the discount / price override)<br />
:# Tick either "Override the price of all products in this profile to" or "Discount all items in this profile by"<br />
:# Fill in the relevant value.<br />
:# Assign the product(s) you want in that profile.<br />
:# Click "Finish"<br />
:# Assign the vendor(s) you want to use that profile.<br />
<br />
'''When you want to change the product(s) in the relevant Sale Vendor(s), simply edit the product listing(s) in that profile. That will update all vendors set to show that profile.'''<br />
<br />
= '''<span style="color:#00528c">A Note On Naming Groups & Profiles</span>''' =<br />
<br />
Group and Profile names MUST be alphanumeric. Symbols will end the Group or Profile name<br />
<br />
= '''<span style="color:#00528c">Not What You Were Looking For?</span>''' =<br />
If this doesn't answer the "How do I...?" question you have, perhaps you need the page on '''[[CasperVend_2/Customers_Page | setting a storewide sale]]''' or the one for '''[[CasperVend_2/Vendor_Discounts | vendor discounts]]''' instead? <br />
<br />
&nbsp;</div>24607dde-d704-4db7-afa0-d9edc17c926chttps://wiki.casperdns.com/index.php?title=CasperVend_2/Profiles_and_groups&diff=15338CasperVend 2/Profiles and groups2023-10-14T14:13:24Z<p>24607dde-d704-4db7-afa0-d9edc17c926c: /* Using Discounts or Price Overrides on Profiles For Recurring Sales */</p>
<hr />
<div><!-- Keywords: range, ranges --><br />
{|align=right<br />
|__TOC__<br />
|}<br />
[[File:German_flag.gif]] [[CasperVend 2/Profiles and groups/DE | Schaue hier in Deutsch!]] <br />
= '''<span style="color:#00528c">Introduction</span>''' =<br />
Profiles specify which products show in a vendor, and the default profile shows EVERYTHING (that you haven't excluded via the product options). So, in order to have only certain products showing in a multi-panel vendor, you need to create a profile containing just those products that you want in that vendor. <br />
<br />
Profiles are applied on a per-vendor basis. You can have many vendors out, each with their own profile.<br />
<br />
Profiles of products '''only''' apply to vendors set '''to''' that profile. They are '''not''' profiles of products, regardless of vendor<br />
<br />
Groups are a sub-category of profiles that allow you to group products together within a profile. For example you can set up individual products (such as a tuxedos, gowns shoes, and casual wear) and then group those products into groups (such as "mens formal", "womens formal", "footwear", etc.) and then put one or more groups into a profile (such as adding the "mens formal" and "womens formal" groups into a profile called "formal wear") and point a multi-panel vendor to that profile. <br />
<br />
Profiles can be applied directly to a vendor, but groups '''cannot'''. You must put a group within a profile, and then point the vendor to that profile.<br />
<br />
= '''<span style="color:#00528c">Profiles</span>''' =<br />
<br />
=== Creating a New Profile ===<br />
----<br />
<br />
:# Log in to the website<br />
:# Go to the "profiles" tab<br />
:# Click "Create New"<br />
:# You'll be taken to a screen with two white boxes <br />
:# Select a product from the left white box that you want to show in the vendor, and click the [-->] button. This will add the product to the profile. Repeat with each additional product you want in the profile. <br />
::: ''There is currently no way to select only some of the products. You can only move one, or move them all, nothing in between.''<br />
<br />
When you're done, click "Finish". Your profile is now ready for use!<br />
<br />
{| <br />
| [[File:CasperVend_Profiles.png|200px|thumb|right|Image of profile setup screen. Click to see larger version.]] <br />
|}<br />
<br />
=== New Profile From Vendor's Configuration Page ===<br />
----<br />
If you want to demo different products from different vendors, you need to put those products into a profile for the HoloVend. This can be done via the Caspervend website, the same way you'd put a multi-item vendor into a profile. <br />
<br />
# Click the CasperVend log on the face of the HoloVend.<br />
# You'll be sent a URL in a popup box, and in local chat.<br />
# Use that link to go to the website and log in.<br />
# If you have never used CasperVend before, '''[[CasperVend_2/Password_Reset#Creating_Your_CasperVend_Account | create your account]]''' now.<br />
# If you have '''forgotten''' your password, use the '''[[CasperVend_2/Password_Reset#Resetting_Your_CasperVend_Password | reset instructions.]]'''<br />
# Once you are logged in, you will reach the vendor configuration page.<br />
# Click '''"New Profile"''' next to the "Action" line: <br /> [[file:Vendor-action-newprofile.png|||"New Profile location on vendor config page]]<br />
# On the next screen, give the profile a distinctive name, then click "Next".<br />
# You will arrive at the profile creation page.<br />
# See the '''[[CasperVend_2/Profiles_and_groups | profiles page]]''' for details of how to select products.<br />
# When you are done selecting products for the profile, click "Finish". <br />
# Your vendor will now update to show the products you've selected.<br />
<br />
=== Editing an Existing Profile ===<br />
----<br />
When you want to edit an existing profile, any vendors which are currently set to that profile will be updated to show the current selection of products automatically when you are done. To edit an existing profile, use the following steps: <br />
<br />
:# Access the vendor configuration page, by clicking the (C)asperVend logo in the bottom left hand corner of the vendor.<br />
:# Switch to the "Profiles" tab on the left hand side.<br />
:# Find the profile you wish to edit, and click [Edit] next to it. You'll be taken to a page with two white boxes. <br />
:# Select a product from the left white box that you want to show in the vendor, and click the [-->] button. This will add the product to the profile. Repeat with each additional product you want in the profile. <br />
:: ''There is currently no way to select only several of the products. You can only move one, or move them all, nothing in between.''<br />
:# When you're done, click "Finish". <br />
<br />
=== Using an Existing Profile On Multi-Product Vendors ===<br />
----<br />
For scrolling, multi-product vendors, you need to create a full profile. If you only select a single product on a multi-item vendor, you'll see the same product across all the vendor panels. <br />
<br />
If you have already created a profile, you can assign it to more vendors. This can be convenient because it means if you change the profile in future, all vendors which are set to that profile will also be updated.<br />
<br />
:# Access the vendor configuration page, by clicking the (C)asperVend logo in the bottom left hand corner of the vendor.<br />
:# Look for the configuration option "Profile", and click [Change] next to it.<br />
:# Simply select the profile you want to set to the vendor, then click [Save]. <br />
:# The vendor will then be updated to use your new profile within a couple minutes!<br />
<br />
=== Using a profile on multiple vendors ===<br />
----<br />
The best way to get a profile to "stick" to a vendor - whether one or multiple - is to tell the vendor(s) what profile to use during setup. While you can change the profile later, it will NOT change copies in your SL inventory, object inventory, or marketplace inventory - they can only "hear" the profile change command from the system while they are rezzed inworld.<br />
<br />
As long as the vendor was rezzed inworld to "hear" the profile change command, any future copies of THAT vendor (or vendors) will also use the same new profile. If you have copies of that vendor(s) still in inventory with the old profile, you must delete them and pick up new copies of the vendor(s) with the new profile.<br />
<br />
= '''<span style="color:#00528c">Excluding From Default Profile</span>''' =<br />
As you gain more experience as a merchant, you may find you don't want to have all the products in the "default" (everything) profile. Here's how you can remove existing products from that profile: <br />
<br />
:# Log in to your CasperVend<br />
:# Go to the '''[https://caspervend.casperdns.com/productsNew.php Products]''' tab<br />
:# Show the products you want to exclude from the default<br />
:# Tick the selector boxes on the left of each product (or you can use the "all" button at the top)<br />
:# Scroll down to the bulk updates block <br />
:# Tick the box for "set product options" <br />
:# Tick the option box for "Exclude this product from the default profile"<br />
:# Scroll down and click "Update Selected" <br />
:# Wait for it to process<br />
<br />
All set! <br />
<br />
{| <br />
| [[File:Exclude_from_default.jpg|300px|thumb|left|Arrows pointing to the appropriate options]]<br />
|}<br />
<br />
= '''<span style="color:#00528c">Groups</span>''' =<br />
When you go to create a profile, you can add in individual products, or one (or more) groups, or both. Then a vendor can be pointed to that profile. Groups '''cannot''' be added to a vendor - only single products or a profile. <br />
<br />
=== Creating a New Group ===<br />
----<br />
Because group names will appear in the product list along with your other products, you should give your groups a consistent beginning to the name to sort them to one findable place in the list - you could start the group name with ''"Group - "''' for example. <br />
<br />
:# Log in to the CasperVend website<br />
:# Click "Groups" <br />
:# Click "Create New Group"<br />
:# Enter a name for the new product group in the text box and then click "Create"<br />
:# You will be presented with a pair of white boxes, the left one showing your existing products, and the right one starting off empty. <br />
:# Select the products you want to have in this group. Click to select one product, then click the --> right arrow to move it to the box on the right side. You can only move one at a time, or all of them at once. <br />
:# When you are done, click finish. Your group is complete! <br />
<br />
There is currently no way to select only some of the products. You can only move one, or move them all, nothing in between.<br />
<br />
=== Adding a Group to a Profile ===<br />
----<br />
When you want to add a group to an existing profile, any vendors which are currently set to that profile will be updated to show the current selection of products - including the grouped products - automatically when you are done. To edit an existing profile, use the following steps: <br />
<br />
:# Access the vendor configuration page, by clicking the (C)asperVend logo in the bottom left hand corner of the vendor.<br />
:# Switch to the "Profiles" tab on the left hand side.<br />
:# Find the profile you wish to edit, and click [Edit] next to it. You'll be taken to a page with two white boxes. <br />
:# Select a product from the left white box that you want to show in the vendor, and click the [-->] button. This will add the product to the profile. Repeat with each additional product you want in the profile. <br />
:# When you're done, click "Finish". <br />
<br />
There is currently no way to select only some of the products. You can only move one, or move them all, nothing in between.<br />
<br />
= '''<span style="color:#00528c">Setting Discounts on Profiles</span>''' =<br />
Discounts on profiles will give all customers (not just group members) a discount off the regular price of everything in that profile. (The "regular price" is the price you set in the product listing.) <br />
<br />
'''''Discounts on profiles only apply to the vendor(s) set to SHOW that profile. It is not a profile of products, regardless of what vendor they are shown on.'''''<br />
<br />
:# Log in to the website<br />
:# Go to the "profiles" tab<br />
:# Find the profile you want to offer a discount on, and click "Edit" next to it<br />
:# You'll be taken to the profile screen with the two white boxes<br />
:# Above those two white boxes are three checkboxes<br />
:# Tick the box for "Discount all items in this profile by ____%" and fill in the % discount<br />
:# Click finish<br />
:# All set!<br />
<br />
= '''<span style="color:#00528c">Setting Price Overrides on Profiles</span>''' =<br />
Price overrides on profiles will override the product pricing of '''everything''' in '''that''' profile, regardless of any sale going on at that time, making them all cost the amount you put in the little box. Be absolutely certain you want to do this, especially if you have an expensive build in the profile that you don't want sold at a really cheap price. <br />
<br />
'''''Price overrides on profiles only apply to the vendor(s) set to SHOW that profile. It is not a profile of products, regardless of what vendor they are shown on.'''''<br />
<br />
:# Log in to the website<br />
:# Go to the "profiles" tab<br />
:# Find the profile you want to offer a discount on, and click "Edit" next to it<br />
:# You'll be taken to the profile screen with the two white boxes<br />
:# Above those two white boxes are three checkboxes<br />
:# Tick the box for "Override the price of all products in this profile to L$___" and fill in the override price <br />
:# Click finish<br />
:# All set!<br />
<br />
=== Using Discounts or Price Overrides on Profiles For Recurring Sales===<br />
----<br />
<br />
For weekly / monthly sale events, for which you want to rotate the product on discount / price override, there is a simple method.<br />
This can be applied for single products (in single product vendors set to that profile), or multiple products (in multi-panel vendors set to that profile), and can be beneficial if you have several vendors running that sale (regardless of whether on the same or different regions).<br />
<br />
:# Create the profile, and give it a unique name (eg named as per the discount / price override)<br />
:# Tick either "Override the price of all products in this profile to" or "Discount all items in this profile by"<br />
:# Fill in the relevant value.<br />
:# Assign the product(s) you want in that profile.<br />
:# Click "Finish"<br />
:# Assign the vendor(s) you want to use that profile.<br />
<br />
'''When you want to change the product(s) in the relevant Sale Vendor(s), simply edit the product listing(s) in that profile. That will update all vendors set to show that profile.'''<br />
<br />
= '''<span style="color:#00528c">A Note On Naming Groups & Profiles</span>''' =<br />
<br />
Group and Profile names MUST be alphanumeric. Symbols will end the Group or Profile name<br />
<br />
= '''<span style="color:#00528c">Not What You Were Looking For?</span>''' =<br />
If this doesn't answer the "How do I...?" question you have, perhaps you need the page on '''[[CasperVend_2/Customers_Page | setting a storewide sale]]''' or the one for '''[[CasperVend_2/Vendor_Discounts | vendor discounts]]''' instead? <br />
<br />
&nbsp;</div>24607dde-d704-4db7-afa0-d9edc17c926chttps://wiki.casperdns.com/index.php?title=CasperVend_2/Profiles_and_groups&diff=15337CasperVend 2/Profiles and groups2023-10-14T14:07:34Z<p>24607dde-d704-4db7-afa0-d9edc17c926c: </p>
<hr />
<div><!-- Keywords: range, ranges --><br />
{|align=right<br />
|__TOC__<br />
|}<br />
[[File:German_flag.gif]] [[CasperVend 2/Profiles and groups/DE | Schaue hier in Deutsch!]] <br />
= '''<span style="color:#00528c">Introduction</span>''' =<br />
Profiles specify which products show in a vendor, and the default profile shows EVERYTHING (that you haven't excluded via the product options). So, in order to have only certain products showing in a multi-panel vendor, you need to create a profile containing just those products that you want in that vendor. <br />
<br />
Profiles are applied on a per-vendor basis. You can have many vendors out, each with their own profile.<br />
<br />
Profiles of products '''only''' apply to vendors set '''to''' that profile. They are '''not''' profiles of products, regardless of vendor<br />
<br />
Groups are a sub-category of profiles that allow you to group products together within a profile. For example you can set up individual products (such as a tuxedos, gowns shoes, and casual wear) and then group those products into groups (such as "mens formal", "womens formal", "footwear", etc.) and then put one or more groups into a profile (such as adding the "mens formal" and "womens formal" groups into a profile called "formal wear") and point a multi-panel vendor to that profile. <br />
<br />
Profiles can be applied directly to a vendor, but groups '''cannot'''. You must put a group within a profile, and then point the vendor to that profile.<br />
<br />
= '''<span style="color:#00528c">Profiles</span>''' =<br />
<br />
=== Creating a New Profile ===<br />
----<br />
<br />
:# Log in to the website<br />
:# Go to the "profiles" tab<br />
:# Click "Create New"<br />
:# You'll be taken to a screen with two white boxes <br />
:# Select a product from the left white box that you want to show in the vendor, and click the [-->] button. This will add the product to the profile. Repeat with each additional product you want in the profile. <br />
::: ''There is currently no way to select only some of the products. You can only move one, or move them all, nothing in between.''<br />
<br />
When you're done, click "Finish". Your profile is now ready for use!<br />
<br />
{| <br />
| [[File:CasperVend_Profiles.png|200px|thumb|right|Image of profile setup screen. Click to see larger version.]] <br />
|}<br />
<br />
=== New Profile From Vendor's Configuration Page ===<br />
----<br />
If you want to demo different products from different vendors, you need to put those products into a profile for the HoloVend. This can be done via the Caspervend website, the same way you'd put a multi-item vendor into a profile. <br />
<br />
# Click the CasperVend log on the face of the HoloVend.<br />
# You'll be sent a URL in a popup box, and in local chat.<br />
# Use that link to go to the website and log in.<br />
# If you have never used CasperVend before, '''[[CasperVend_2/Password_Reset#Creating_Your_CasperVend_Account | create your account]]''' now.<br />
# If you have '''forgotten''' your password, use the '''[[CasperVend_2/Password_Reset#Resetting_Your_CasperVend_Password | reset instructions.]]'''<br />
# Once you are logged in, you will reach the vendor configuration page.<br />
# Click '''"New Profile"''' next to the "Action" line: <br /> [[file:Vendor-action-newprofile.png|||"New Profile location on vendor config page]]<br />
# On the next screen, give the profile a distinctive name, then click "Next".<br />
# You will arrive at the profile creation page.<br />
# See the '''[[CasperVend_2/Profiles_and_groups | profiles page]]''' for details of how to select products.<br />
# When you are done selecting products for the profile, click "Finish". <br />
# Your vendor will now update to show the products you've selected.<br />
<br />
=== Editing an Existing Profile ===<br />
----<br />
When you want to edit an existing profile, any vendors which are currently set to that profile will be updated to show the current selection of products automatically when you are done. To edit an existing profile, use the following steps: <br />
<br />
:# Access the vendor configuration page, by clicking the (C)asperVend logo in the bottom left hand corner of the vendor.<br />
:# Switch to the "Profiles" tab on the left hand side.<br />
:# Find the profile you wish to edit, and click [Edit] next to it. You'll be taken to a page with two white boxes. <br />
:# Select a product from the left white box that you want to show in the vendor, and click the [-->] button. This will add the product to the profile. Repeat with each additional product you want in the profile. <br />
:: ''There is currently no way to select only several of the products. You can only move one, or move them all, nothing in between.''<br />
:# When you're done, click "Finish". <br />
<br />
=== Using an Existing Profile On Multi-Product Vendors ===<br />
----<br />
For scrolling, multi-product vendors, you need to create a full profile. If you only select a single product on a multi-item vendor, you'll see the same product across all the vendor panels. <br />
<br />
If you have already created a profile, you can assign it to more vendors. This can be convenient because it means if you change the profile in future, all vendors which are set to that profile will also be updated.<br />
<br />
:# Access the vendor configuration page, by clicking the (C)asperVend logo in the bottom left hand corner of the vendor.<br />
:# Look for the configuration option "Profile", and click [Change] next to it.<br />
:# Simply select the profile you want to set to the vendor, then click [Save]. <br />
:# The vendor will then be updated to use your new profile within a couple minutes!<br />
<br />
=== Using a profile on multiple vendors ===<br />
----<br />
The best way to get a profile to "stick" to a vendor - whether one or multiple - is to tell the vendor(s) what profile to use during setup. While you can change the profile later, it will NOT change copies in your SL inventory, object inventory, or marketplace inventory - they can only "hear" the profile change command from the system while they are rezzed inworld.<br />
<br />
As long as the vendor was rezzed inworld to "hear" the profile change command, any future copies of THAT vendor (or vendors) will also use the same new profile. If you have copies of that vendor(s) still in inventory with the old profile, you must delete them and pick up new copies of the vendor(s) with the new profile.<br />
<br />
= '''<span style="color:#00528c">Excluding From Default Profile</span>''' =<br />
As you gain more experience as a merchant, you may find you don't want to have all the products in the "default" (everything) profile. Here's how you can remove existing products from that profile: <br />
<br />
:# Log in to your CasperVend<br />
:# Go to the '''[https://caspervend.casperdns.com/productsNew.php Products]''' tab<br />
:# Show the products you want to exclude from the default<br />
:# Tick the selector boxes on the left of each product (or you can use the "all" button at the top)<br />
:# Scroll down to the bulk updates block <br />
:# Tick the box for "set product options" <br />
:# Tick the option box for "Exclude this product from the default profile"<br />
:# Scroll down and click "Update Selected" <br />
:# Wait for it to process<br />
<br />
All set! <br />
<br />
{| <br />
| [[File:Exclude_from_default.jpg|300px|thumb|left|Arrows pointing to the appropriate options]]<br />
|}<br />
<br />
= '''<span style="color:#00528c">Groups</span>''' =<br />
When you go to create a profile, you can add in individual products, or one (or more) groups, or both. Then a vendor can be pointed to that profile. Groups '''cannot''' be added to a vendor - only single products or a profile. <br />
<br />
=== Creating a New Group ===<br />
----<br />
Because group names will appear in the product list along with your other products, you should give your groups a consistent beginning to the name to sort them to one findable place in the list - you could start the group name with ''"Group - "''' for example. <br />
<br />
:# Log in to the CasperVend website<br />
:# Click "Groups" <br />
:# Click "Create New Group"<br />
:# Enter a name for the new product group in the text box and then click "Create"<br />
:# You will be presented with a pair of white boxes, the left one showing your existing products, and the right one starting off empty. <br />
:# Select the products you want to have in this group. Click to select one product, then click the --> right arrow to move it to the box on the right side. You can only move one at a time, or all of them at once. <br />
:# When you are done, click finish. Your group is complete! <br />
<br />
There is currently no way to select only some of the products. You can only move one, or move them all, nothing in between.<br />
<br />
=== Adding a Group to a Profile ===<br />
----<br />
When you want to add a group to an existing profile, any vendors which are currently set to that profile will be updated to show the current selection of products - including the grouped products - automatically when you are done. To edit an existing profile, use the following steps: <br />
<br />
:# Access the vendor configuration page, by clicking the (C)asperVend logo in the bottom left hand corner of the vendor.<br />
:# Switch to the "Profiles" tab on the left hand side.<br />
:# Find the profile you wish to edit, and click [Edit] next to it. You'll be taken to a page with two white boxes. <br />
:# Select a product from the left white box that you want to show in the vendor, and click the [-->] button. This will add the product to the profile. Repeat with each additional product you want in the profile. <br />
:# When you're done, click "Finish". <br />
<br />
There is currently no way to select only some of the products. You can only move one, or move them all, nothing in between.<br />
<br />
= '''<span style="color:#00528c">Setting Discounts on Profiles</span>''' =<br />
Discounts on profiles will give all customers (not just group members) a discount off the regular price of everything in that profile. (The "regular price" is the price you set in the product listing.) <br />
<br />
'''''Discounts on profiles only apply to the vendor(s) set to SHOW that profile. It is not a profile of products, regardless of what vendor they are shown on.'''''<br />
<br />
:# Log in to the website<br />
:# Go to the "profiles" tab<br />
:# Find the profile you want to offer a discount on, and click "Edit" next to it<br />
:# You'll be taken to the profile screen with the two white boxes<br />
:# Above those two white boxes are three checkboxes<br />
:# Tick the box for "Discount all items in this profile by ____%" and fill in the % discount<br />
:# Click finish<br />
:# All set!<br />
<br />
= '''<span style="color:#00528c">Setting Price Overrides on Profiles</span>''' =<br />
Price overrides on profiles will override the product pricing of '''everything''' in '''that''' profile, regardless of any sale going on at that time, making them all cost the amount you put in the little box. Be absolutely certain you want to do this, especially if you have an expensive build in the profile that you don't want sold at a really cheap price. <br />
<br />
'''''Price overrides on profiles only apply to the vendor(s) set to SHOW that profile. It is not a profile of products, regardless of what vendor they are shown on.'''''<br />
<br />
:# Log in to the website<br />
:# Go to the "profiles" tab<br />
:# Find the profile you want to offer a discount on, and click "Edit" next to it<br />
:# You'll be taken to the profile screen with the two white boxes<br />
:# Above those two white boxes are three checkboxes<br />
:# Tick the box for "Override the price of all products in this profile to L$___" and fill in the override price <br />
:# Click finish<br />
:# All set!<br />
<br />
=== Using Discounts or Price Overrides on Profiles For Recurring Sales===<br />
----<br />
<br />
For weekly / monthly sale events, for which you want to rotate the product on discount / price override, there is a simple method.<br />
This can be applied for single products, or multiple products, and can be beneficial if you have several vendors running that sale (regardless of whether on the same or different regions).<br />
<br />
:# Create the profile, and give it a unique name (eg named as per the discount / price override)<br />
:# Tick either "Override the price of all products in this profile to" or "Discount all items in this profile by"<br />
:# Fill in the relevant value.<br />
:# Assign the product(s) you want in that profile.<br />
:# Click "Finish"<br />
:# Assign the vendor(s) you want to use that profile.<br />
<br />
'''When you want to change the product(s) in the relevant Sale Vendor(s), simply edit the product listing(s) in that profile. That will update all vendors set to show that profile.'''<br />
<br />
<br />
= '''<span style="color:#00528c">A Note On Naming Groups & Profiles</span>''' =<br />
<br />
Group and Profile names MUST be alphanumeric. Symbols will end the Group or Profile name<br />
<br />
= '''<span style="color:#00528c">Not What You Were Looking For?</span>''' =<br />
If this doesn't answer the "How do I...?" question you have, perhaps you need the page on '''[[CasperVend_2/Customers_Page | setting a storewide sale]]''' or the one for '''[[CasperVend_2/Vendor_Discounts | vendor discounts]]''' instead? <br />
<br />
&nbsp;</div>24607dde-d704-4db7-afa0-d9edc17c926chttps://wiki.casperdns.com/index.php?title=CasperVend_2/Profiles_and_groups&diff=15336CasperVend 2/Profiles and groups2023-10-14T13:51:42Z<p>24607dde-d704-4db7-afa0-d9edc17c926c: </p>
<hr />
<div><!-- Keywords: range, ranges --><br />
{|align=right<br />
|__TOC__<br />
|}<br />
[[File:German_flag.gif]] [[CasperVend 2/Profiles and groups/DE | Schaue hier in Deutsch!]] <br />
= '''<span style="color:#00528c">Introduction</span>''' =<br />
Profiles specify which products show in a vendor, and the default profile shows EVERYTHING (that you haven't excluded via the product options). So, in order to have only certain products showing in a multi-panel vendor, you need to create a profile containing just those products that you want in that vendor. <br />
<br />
Profiles are applied on a per-vendor basis. You can have many vendors out, each with their own profile.<br />
<br />
Profiles of products '''only''' apply to vendors set '''to''' that profile. They are '''not''' profiles of products, regardless of vendor<br />
<br />
Groups are a sub-category of profiles that allow you to group products together within a profile. For example you can set up individual products (such as a tuxedos, gowns shoes, and casual wear) and then group those products into groups (such as "mens formal", "womens formal", "footwear", etc.) and then put one or more groups into a profile (such as adding the "mens formal" and "womens formal" groups into a profile called "formal wear") and point a multi-panel vendor to that profile. <br />
<br />
Profiles can be applied directly to a vendor, but groups '''cannot'''. You must put a group within a profile, and then point the vendor to that profile.<br />
<br />
= '''<span style="color:#00528c">Profiles</span>''' =<br />
<br />
=== Creating a New Profile ===<br />
----<br />
<br />
:# Log in to the website<br />
:# Go to the "profiles" tab<br />
:# Click "Create New"<br />
:# You'll be taken to a screen with two white boxes <br />
:# Select a product from the left white box that you want to show in the vendor, and click the [-->] button. This will add the product to the profile. Repeat with each additional product you want in the profile. <br />
::: ''There is currently no way to select only some of the products. You can only move one, or move them all, nothing in between.''<br />
<br />
When you're done, click "Finish". Your profile is now ready for use!<br />
<br />
{| <br />
| [[File:CasperVend_Profiles.png|200px|thumb|right|Image of profile setup screen. Click to see larger version.]] <br />
|}<br />
<br />
=== New Profile From Vendor's Configuration Page ===<br />
----<br />
If you want to demo different products from different vendors, you need to put those products into a profile for the HoloVend. This can be done via the Caspervend website, the same way you'd put a multi-item vendor into a profile. <br />
<br />
# Click the CasperVend log on the face of the HoloVend.<br />
# You'll be sent a URL in a popup box, and in local chat.<br />
# Use that link to go to the website and log in.<br />
# If you have never used CasperVend before, '''[[CasperVend_2/Password_Reset#Creating_Your_CasperVend_Account | create your account]]''' now.<br />
# If you have '''forgotten''' your password, use the '''[[CasperVend_2/Password_Reset#Resetting_Your_CasperVend_Password | reset instructions.]]'''<br />
# Once you are logged in, you will reach the vendor configuration page.<br />
# Click '''"New Profile"''' next to the "Action" line: <br /> [[file:Vendor-action-newprofile.png|||"New Profile location on vendor config page]]<br />
# On the next screen, give the profile a distinctive name, then click "Next".<br />
# You will arrive at the profile creation page.<br />
# See the '''[[CasperVend_2/Profiles_and_groups | profiles page]]''' for details of how to select products.<br />
# When you are done selecting products for the profile, click "Finish". <br />
# Your vendor will now update to show the products you've selected.<br />
<br />
=== Editing an Existing Profile ===<br />
----<br />
When you want to edit an existing profile, any vendors which are currently set to that profile will be updated to show the current selection of products automatically when you are done. To edit an existing profile, use the following steps: <br />
<br />
:# Access the vendor configuration page, by clicking the (C)asperVend logo in the bottom left hand corner of the vendor.<br />
:# Switch to the "Profiles" tab on the left hand side.<br />
:# Find the profile you wish to edit, and click [Edit] next to it. You'll be taken to a page with two white boxes. <br />
:# Select a product from the left white box that you want to show in the vendor, and click the [-->] button. This will add the product to the profile. Repeat with each additional product you want in the profile. <br />
:: ''There is currently no way to select only several of the products. You can only move one, or move them all, nothing in between.''<br />
:# When you're done, click "Finish". <br />
<br />
=== Using an Existing Profile On Multi-Product Vendors ===<br />
----<br />
For scrolling, multi-product vendors, you need to create a full profile. If you only select a single product on a multi-item vendor, you'll see the same product across all the vendor panels. <br />
<br />
If you have already created a profile, you can assign it to more vendors. This can be convenient because it means if you change the profile in future, all vendors which are set to that profile will also be updated.<br />
<br />
:# Access the vendor configuration page, by clicking the (C)asperVend logo in the bottom left hand corner of the vendor.<br />
:# Look for the configuration option "Profile", and click [Change] next to it.<br />
:# Simply select the profile you want to set to the vendor, then click [Save]. <br />
:# The vendor will then be updated to use your new profile within a couple minutes!<br />
<br />
=== Using a profile on multiple vendors ===<br />
----<br />
The best way to get a profile to "stick" to a vendor - whether one or multiple - is to tell the vendor(s) what profile to use during setup. While you can change the profile later, it will NOT change copies in your SL inventory, object inventory, or marketplace inventory - they can only "hear" the profile change command from the system while they are rezzed inworld.<br />
<br />
As long as the vendor was rezzed inworld to "hear" the profile change command, any future copies of THAT vendor (or vendors) will also use the same new profile. If you have copies of that vendor(s) still in inventory with the old profile, you must delete them and pick up new copies of the vendor(s) with the new profile.<br />
<br />
= '''<span style="color:#00528c">Excluding From Default Profile</span>''' =<br />
As you gain more experience as a merchant, you may find you don't want to have all the products in the "default" (everything) profile. Here's how you can remove existing products from that profile: <br />
<br />
:# Log in to your CasperVend<br />
:# Go to the '''[https://caspervend.casperdns.com/productsNew.php Products]''' tab<br />
:# Show the products you want to exclude from the default<br />
:# Tick the selector boxes on the left of each product (or you can use the "all" button at the top)<br />
:# Scroll down to the bulk updates block <br />
:# Tick the box for "set product options" <br />
:# Tick the option box for "Exclude this product from the default profile"<br />
:# Scroll down and click "Update Selected" <br />
:# Wait for it to process<br />
<br />
All set! <br />
<br />
{| <br />
| [[File:Exclude_from_default.jpg|300px|thumb|left|Arrows pointing to the appropriate options]]<br />
|}<br />
<br />
= '''<span style="color:#00528c">Groups</span>''' =<br />
When you go to create a profile, you can add in individual products, or one (or more) groups, or both. Then a vendor can be pointed to that profile. Groups '''cannot''' be added to a vendor - only single products or a profile. <br />
<br />
=== Creating a New Group ===<br />
----<br />
Because group names will appear in the product list along with your other products, you should give your groups a consistent beginning to the name to sort them to one findable place in the list - you could start the group name with ''"Group - "''' for example. <br />
<br />
:# Log in to the CasperVend website<br />
:# Click "Groups" <br />
:# Click "Create New Group"<br />
:# Enter a name for the new product group in the text box and then click "Create"<br />
:# You will be presented with a pair of white boxes, the left one showing your existing products, and the right one starting off empty. <br />
:# Select the products you want to have in this group. Click to select one product, then click the --> right arrow to move it to the box on the right side. You can only move one at a time, or all of them at once. <br />
:# When you are done, click finish. Your group is complete! <br />
<br />
There is currently no way to select only some of the products. You can only move one, or move them all, nothing in between.<br />
<br />
=== Adding a Group to a Profile ===<br />
----<br />
When you want to add a group to an existing profile, any vendors which are currently set to that profile will be updated to show the current selection of products - including the grouped products - automatically when you are done. To edit an existing profile, use the following steps: <br />
<br />
:# Access the vendor configuration page, by clicking the (C)asperVend logo in the bottom left hand corner of the vendor.<br />
:# Switch to the "Profiles" tab on the left hand side.<br />
:# Find the profile you wish to edit, and click [Edit] next to it. You'll be taken to a page with two white boxes. <br />
:# Select a product from the left white box that you want to show in the vendor, and click the [-->] button. This will add the product to the profile. Repeat with each additional product you want in the profile. <br />
:# When you're done, click "Finish". <br />
<br />
There is currently no way to select only some of the products. You can only move one, or move them all, nothing in between.<br />
<br />
= '''<span style="color:#00528c">Setting Discounts on Profiles</span>''' =<br />
Discounts on profiles will give all customers (not just group members) a discount off the regular price of everything in that profile. (The "regular price" is the price you set in the product listing.) <br />
<br />
'''''Discounts on profiles only apply to the vendor(s) set to SHOW that profile. It is not a profile of products, regardless of what vendor they are shown on.'''''<br />
<br />
:# Log in to the website<br />
:# Go to the "profiles" tab<br />
:# Find the profile you want to offer a discount on, and click "Edit" next to it<br />
:# You'll be taken to the profile screen with the two white boxes<br />
:# Above those two white boxes are three checkboxes<br />
:# Tick the box for "Discount all items in this profile by ____%" and fill in the % discount<br />
:# Click finish<br />
:# All set!<br />
<br />
= '''<span style="color:#00528c">Setting Price Overrides on Profiles</span>''' =<br />
Price overrides on profiles will override the product pricing of '''everything''' in '''that''' profile, regardless of any sale going on at that time, making them all cost the amount you put in the little box. Be absolutely certain you want to do this, especially if you have an expensive build in the profile that you don't want sold at a really cheap price. <br />
<br />
'''''Price overrides on profiles only apply to the vendor(s) set to SHOW that profile. It is not a profile of products, regardless of what vendor they are shown on.'''''<br />
<br />
:# Log in to the website<br />
:# Go to the "profiles" tab<br />
:# Find the profile you want to offer a discount on, and click "Edit" next to it<br />
:# You'll be taken to the profile screen with the two white boxes<br />
:# Above those two white boxes are three checkboxes<br />
:# Tick the box for "Override the price of all products in this profile to L$___" and fill in the override price <br />
:# Click finish<br />
:# All set!<br />
<br />
= '''<span style="color:#00528c">A Note On Naming Groups & Profiles</span>''' =<br />
<br />
Group and Profile names MUST be alphanumeric. Symbols will end the Group or Profile name<br />
<br />
= '''<span style="color:#00528c">Not What You Were Looking For?</span>''' =<br />
If this doesn't answer the "How do I...?" question you have, perhaps you need the page on '''[[CasperVend_2/Customers_Page | setting a storewide sale]]''' or the one for '''[[CasperVend_2/Vendor_Discounts | vendor discounts]]''' instead? <br />
<br />
&nbsp;</div>24607dde-d704-4db7-afa0-d9edc17c926chttps://wiki.casperdns.com/index.php?title=CasperVend_2/Profiles_and_groups&diff=15335CasperVend 2/Profiles and groups2023-10-14T13:49:32Z<p>24607dde-d704-4db7-afa0-d9edc17c926c: /* Introduction */</p>
<hr />
<div><!-- Keywords: range, ranges --><br />
{|align=right<br />
|__TOC__<br />
|}<br />
[[File:German_flag.gif]] [[CasperVend 2/Profiles and groups/DE | Schaue hier in Deutsch!]] <br />
= '''<span style="color:#00528c">Introduction</span>''' =<br />
Profiles specify which products show in a vendor, and the default profile shows EVERYTHING (that you haven't excluded via the product options). So, in order to have only certain products showing in a multi-panel vendor, you need to create a profile containing just those products that you want in that vendor. <br />
<br />
Profiles are applied on a per-vendor basis. You can have many vendors out, each with their own profile.<br />
<br />
Profiles of products '''only''' apply to vendors set '''to''' that profile. They are '''not''' profiles of products, regardless of vendor<br />
<br />
Groups are a sub-category of profiles that allow you to group products together within a profile. For example you can set up individual products (such as a tuxedos, gowns shoes, and casual wear) and then group those products into groups (such as "mens formal", "womens formal", "footwear", etc.) and then put one or more groups into a profile (such as adding the "mens formal" and "womens formal" groups into a profile called "formal wear") and point a multi-panel vendor to that profile. <br />
<br />
Profiles can be applied directly to a vendor, but groups '''cannot'''. You must put a group within a profile, and then point the vendor to that profile.<br />
<br />
= '''<span style="color:#00528c">Profiles</span>''' =<br />
<br />
=== Creating a New Profile ===<br />
----<br />
<br />
:# Log in to the website<br />
:# Go to the "profiles" tab<br />
:# Click "Create New"<br />
:# You'll be taken to a screen with two white boxes <br />
:# Select a product from the left white box that you want to show in the vendor, and click the [-->] button. This will add the product to the profile. Repeat with each additional product you want in the profile. <br />
::: ''There is currently no way to select only some of the products. You can only move one, or move them all, nothing in between.''<br />
<br />
When you're done, click "Finish". Your profile is now ready for use!<br />
<br />
{| <br />
| [[File:CasperVend_Profiles.png|200px|thumb|right|Image of profile setup screen. Click to see larger version.]] <br />
|}<br />
<br />
=== New Profile From Vendor's Configuration Page ===<br />
----<br />
If you want to demo different products from different vendors, you need to put those products into a profile for the HoloVend. This can be done via the Caspervend website, the same way you'd put a multi-item vendor into a profile. <br />
<br />
# Click the CasperVend log on the face of the HoloVend.<br />
# You'll be sent a URL in a popup box, and in local chat.<br />
# Use that link to go to the website and log in.<br />
# If you have never used CasperVend before, '''[[CasperVend_2/Password_Reset#Creating_Your_CasperVend_Account | create your account]]''' now.<br />
# If you have '''forgotten''' your password, use the '''[[CasperVend_2/Password_Reset#Resetting_Your_CasperVend_Password | reset instructions.]]'''<br />
# Once you are logged in, you will reach the vendor configuration page.<br />
# Click '''"New Profile"''' next to the "Action" line: <br /> [[file:Vendor-action-newprofile.png|||"New Profile location on vendor config page]]<br />
# On the next screen, give the profile a distinctive name, then click "Next".<br />
# You will arrive at the profile creation page.<br />
# See the '''[[CasperVend_2/Profiles_and_groups | profiles page]]''' for details of how to select products.<br />
# When you are done selecting products for the profile, click "Finish". <br />
# Your vendor will now update to show the products you've selected.<br />
<br />
=== Editing an Existing Profile ===<br />
----<br />
When you want to edit an existing profile, any vendors which are currently set to that profile will be updated to show the current selection of products automatically when you are done. To edit an existing profile, use the following steps: <br />
<br />
:# Access the vendor configuration page, by clicking the (C)asperVend logo in the bottom left hand corner of the vendor.<br />
:# Switch to the "Profiles" tab on the left hand side.<br />
:# Find the profile you wish to edit, and click [Edit] next to it. You'll be taken to a page with two white boxes. <br />
:# Select a product from the left white box that you want to show in the vendor, and click the [-->] button. This will add the product to the profile. Repeat with each additional product you want in the profile. <br />
:: ''There is currently no way to select only several of the products. You can only move one, or move them all, nothing in between.''<br />
:# When you're done, click "Finish". <br />
<br />
=== Using an Existing Profile On Multi-Product Vendors ===<br />
----<br />
For scrolling, multi-product vendors, you need to create a full profile. If you only select a single product on a multi-item vendor, you'll see the same product across all the vendor panels. <br />
<br />
If you have already created a profile, you can assign it to more vendors. This can be convenient because it means if you change the profile in future, all vendors which are set to that profile will also be updated.<br />
<br />
:# Access the vendor configuration page, by clicking the (C)asperVend logo in the bottom left hand corner of the vendor.<br />
:# Look for the configuration option "Profile", and click [Change] next to it.<br />
:# Simply select the profile you want to set to the vendor, then click [Save]. <br />
:# The vendor will then be updated to use your new profile within a couple minutes!<br />
<br />
=== Using a profile on multiple vendors ===<br />
----<br />
The best way to get a profile to "stick" to a vendor - whether one or multiple - is to tell the vendor(s) what profile to use during setup. While you can change the profile later, it will NOT change copies in your SL inventory, object inventory, or marketplace inventory - they can only "hear" the profile change command from the system while they are rezzed inworld.<br />
<br />
As long as the vendor was rezzed inworld to "hear" the profile change command, any future copies of THAT vendor (or vendors) will also use the same new profile. If you have copies of that vendor(s) still in inventory with the old profile, you must delete them and pick up new copies of the vendor(s) with the new profile.<br />
<br />
= '''<span style="color:#00528c">Excluding From Default Profile</span>''' =<br />
As you gain more experience as a merchant, you may find you don't want to have all the products in the "default" (everything) profile. Here's how you can remove existing products from that profile: <br />
<br />
:# Log in to your CasperVend<br />
:# Go to the '''[https://caspervend.casperdns.com/productsNew.php Products]''' tab<br />
:# Show the products you want to exclude from the default<br />
:# Tick the selector boxes on the left of each product (or you can use the "all" button at the top)<br />
:# Scroll down to the bulk updates block <br />
:# Tick the box for "set product options" <br />
:# Tick the option box for "Exclude this product from the default profile"<br />
:# Scroll down and click "Update Selected" <br />
:# Wait for it to process<br />
<br />
All set! <br />
<br />
{| <br />
| [[File:Exclude_from_default.jpg|300px|thumb|left|Arrows pointing to the appropriate options]]<br />
|}<br />
<br />
= '''<span style="color:#00528c">Groups</span>''' =<br />
When you go to create a profile, you can add in individual products, or one (or more) groups, or both. Then a vendor can be pointed to that profile. Groups '''cannot''' be added to a vendor - only single products or a profile. <br />
<br />
=== Creating a New Group ===<br />
----<br />
Because group names will appear in the product list along with your other products, you should give your groups a consistent beginning to the name to sort them to one findable place in the list - you could start the group name with ''"Group - "''' for example. <br />
<br />
:# Log in to the CasperVend website<br />
:# Click "Groups" <br />
:# Click "Create New Group"<br />
:# Enter a name for the new product group in the text box and then click "Create"<br />
:# You will be presented with a pair of white boxes, the left one showing your existing products, and the right one starting off empty. <br />
:# Select the products you want to have in this group. Click to select one product, then click the --> right arrow to move it to the box on the right side. You can only move one at a time, or all of them at once. <br />
:# When you are done, click finish. Your group is complete! <br />
<br />
There is currently no way to select only some of the products. You can only move one, or move them all, nothing in between.<br />
<br />
=== Adding a Group to a Profile ===<br />
----<br />
When you want to add a group to an existing profile, any vendors which are currently set to that profile will be updated to show the current selection of products - including the grouped products - automatically when you are done. To edit an existing profile, use the following steps: <br />
<br />
:# Access the vendor configuration page, by clicking the (C)asperVend logo in the bottom left hand corner of the vendor.<br />
:# Switch to the "Profiles" tab on the left hand side.<br />
:# Find the profile you wish to edit, and click [Edit] next to it. You'll be taken to a page with two white boxes. <br />
:# Select a product from the left white box that you want to show in the vendor, and click the [-->] button. This will add the product to the profile. Repeat with each additional product you want in the profile. <br />
:# When you're done, click "Finish". <br />
<br />
There is currently no way to select only some of the products. You can only move one, or move them all, nothing in between.<br />
<br />
= '''<span style="color:#00528c">Setting Discounts on Profiles</span>''' =<br />
Discounts on profiles will give all customers (not just group members) a discount off the regular price of everything in that profile. (The "regular price" is the price you set in the product listing.) <br />
<br />
'''''Discounts on profiles only apply to the vendor(s) set to SHOW that profile. It is not a profile of products, regardless of what vendor they are shown on.'''''<br />
<br />
:# Log in to the website<br />
:# Go to the "profiles" tab<br />
:# Find the profile you want to offer a discount on, and click "Edit" next to it<br />
:# You'll be taken to the profile screen with the two white boxes<br />
:# Above those two white boxes are three checkboxes<br />
:# Tick the box for "Discount all items in this profile by ____%" and fill in the % discount<br />
:# Click finish<br />
:# All set!<br />
<br />
= '''<span style="color:#00528c">Setting Price Overrides on Profiles</span>''' =<br />
Price overrides on profiles will override the product pricing of '''everything''' in '''that''' profile, regardless of any sale going on at that time, making them all cost the amount you put in the little box. Be absolutely certain you want to do this, especially if you have an expensive build in the profile that you don't want sold at a really cheap price. <br />
<br />
Price overrides on profiles only apply to the vendor(s) set to SHOW that profile. It is not a profile of products, regardless of what vendor they are shown on.<br />
<br />
:# Log in to the website<br />
:# Go to the "profiles" tab<br />
:# Find the profile you want to offer a discount on, and click "Edit" next to it<br />
:# You'll be taken to the profile screen with the two white boxes<br />
:# Above those two white boxes are three checkboxes<br />
:# Tick the box for "Override the price of all products in this profile to L$___" and fill in the override price <br />
:# Click finish<br />
:# All set!<br />
<br />
= '''<span style="color:#00528c">A Note On Naming Groups & Profiles</span>''' =<br />
<br />
Group and Profile names MUST be alphanumeric. Symbols will end the Group or Profile name<br />
<br />
= '''<span style="color:#00528c">Not What You Were Looking For?</span>''' =<br />
If this doesn't answer the "How do I...?" question you have, perhaps you need the page on '''[[CasperVend_2/Customers_Page | setting a storewide sale]]''' or the one for '''[[CasperVend_2/Vendor_Discounts | vendor discounts]]''' instead? <br />
<br />
&nbsp;</div>24607dde-d704-4db7-afa0-d9edc17c926chttps://wiki.casperdns.com/index.php?title=CasperVend_2/Marketplace_Link&diff=15332CasperVend 2/Marketplace Link2023-10-09T21:47:29Z<p>24607dde-d704-4db7-afa0-d9edc17c926c: </p>
<hr />
<div>{|align=right<br />
|__TOC__<br />
|}<br />
[[File:German_flag.gif]] [[CasperVend 2/Marketplace Link/DE | Schaue hier in Deutsch!]]<br />
<br />
<!-- Keywords: marketplace sales link --><br />
The CasperVend '''Marketplace Link''' allows CasperVend to automatically list your Marketplace sales alongside your inworld sales.<br />
<br />
== '''<span style="color:#00528c">Benefits of SL Marketplace ANS Tracking</span>''' ==<br />
<br />
: '''Track Marketplace Sales Statistics'''<br />
: CasperVend allows sales imported with the Marketplace Link to be displayed and accounted alongside your inworld vendor sales. This allows you to get a much more complete picture of your sales performance, and even compare your inworld sales to your marketplace sales, all from the CasperVend website.<br />
<br />
<br />
: '''Allow Redeliveries of Marketplace Purchases From Inworld'''<br />
: Once you've associated your marketplace item with your CasperVend product, you can redeliver missed sales to your customers - AND - your customers can redeliver their marketplace purchases through your redelivery terminal inworld. Neat, huh?<br />
<br />
<br />
: '''Send Product Updates to Marketplace Customers'''<br />
: CasperVend can include your all customers in on product updates - including anyone who's purchased your products from SL Marketplace. <br />
<br />
<br />
: '''Group Invites'''<br />
: If you have CasperVend set up to automatically send group invites to purchasers, it will also automatically also send invites to people who purchase on Marketplace, based on the sales data received via the ANS link.<br />
<br />
== '''<span style="color:#00528c">Direct Delivery</span>''' ==<br />
On 18 April, 2013, Linden Lab introduced "Direct Delivery" - an entirely new ANS method - which is natively supported by CasperVend. <br />
<br />
==== &nbsp; &nbsp; <span style="color:#F00;">ADITI Beta Test Warning</span> ====<br />
----<br />
If you took place in the Marketplace "Direct Delivery" beta test on Aditi - '''NOT''' the main grid - IT'S VERY IMPORTANT that you disable ANS support (or at least, don't use the caspervend URL) on the Aditi marketplace. If you don't, it can allow people who purchase on the beta grid to get redeliveries on the main grid.<br />
<br />
== '''<span style="color:#00528c">Setting Up Your ANS Link</span>''' ==<br />
Note that this does '''NOT''' involve changes to your SL Marketplace '''products''' in any way. This only sets up one-way communication from the Marketplace database to the CasperVend database. <br />
<br />
<div style="display:inline-block"><br />
{| align="center" class="wikitable" width="100%"<br />
|-<br />
! Steps !! Reference Image <br />
|-<br />
| style="padding-left: 1em" | Visit the [https://marketplace.secondlife.com/ Marketplace website]. || &nbsp; |<br />
|-<br />
| style="padding-left: 1em" | From the user dropdown menu at the top right hand side of the page, choose "Merchant Home". || [[File:Ans1.jpg]] <br />
|-<br />
| style="padding-left: 1em" | From the "Store setup" dropdown, click "Automatic Notifications (ANS)". You will be taken directly to the box where you enter the ANS URL. || [[File:Ans2.jpg]] <br />
|-<br />
| style="padding-left: 1em" | Enter the following Notification URL exactly (pay attention to the http'''s''' and not just http), and then click "Save": <br />'''<nowiki>https://vend.casperdns.com/ans.php</nowiki>'''|| [[File:New_ANS_Notification.png|400px|thumb|left|Click for larger version]]<br />
|-<br />
| style="padding-left: 1em" | The website will display a "Notification Salt". Please copy this into your clipboard (or write it down if you prefer). We will need this in a moment. <br /><br />'''DO NOT use the code displayed in the sample image, use the one displayed on YOUR marketplace account.''' || [[File:Ans5s.png|400px|thumb|left|Click for larger version]] <br />
|-<br />
| style="padding-left: 1em" | Go to the [https://caspervend.casperdns.com// CasperVend website], and login. || &nbsp; |<br />
|-<br />
| style="padding-left: 1em" | Click on "Overview" tab on the left || &nbsp; |<br />
|-<br />
| style="padding-left: 1em" | On the right hand side of the page, there will be a box titled "API configuration". Click [Change] next to "Marketplace ANS Key". || [[File:MarketplaceANS_01.png|400px|thumb|left|Click for larger version]] <br />
|-<br />
| style="padding-left: 1em" | Paste (or key in) the ANS "notification salt" into the box and Click [Change]. || [[File:MarketplaceANS_02.png|400px|thumb|left|Click for larger version]] <br />
|}<br />
</div><br />
That's it, you're done! Your CasperVend account should be ready to accept incoming sales data information momentarily. Remember that nothing will happen '''until''' you have sales coming in.<br />
<br />
== '''<span style="color:#00528c">Associating Items</span>''' ==<br />
<br />
Once the ANS link is set up, CasperVend will watch for '''sales data''' through the ANS feed. Once sales data comes in, it will make a best attempt to match the Marketplace product name with your product name in CasperVend.<br />
<br />
If the matching algorithm isn't certain of the match, it will leave it for you to associate. To do that, visit the Overview, and click "Issues" link (see below)<br />
<br />
==== How Long Before Seeing Products in Association List? ====<br />
----<br />
{{Information|You must wait for sales to happen on Marketplace before they will appear in your association list in CasperVend. }}<br />
<br />
Product association is NOT an immediate process - it requires the '''sales data''' to come in from Marketplace (or the appropriate .csv file to be uploaded) before it can begin its work.<br />
<br />
==== "3rd Party Sales Association" Notification ====<br />
----<br />
If you have products to associate, you will see a red link with "((#)) issues" in one of the top boxes on the Overview page. <br />
<br />
If the link is in red and gives you a '''[[media:Overview_-_Associations_-_Issues.png | ((#)) issues]]''', click that, and you'll be taken to a list of products to associate. <br />
<br />
If the link is green and instead says '''[[media:Associations_All_OK.png | All Ok!]]''' you can still click it, you just won't see a list of items to associate (because there aren't.)<br />
<br />
==== "Third Party Import" page ====<br />
----<br />
<br />
Currently has "radio buttons" for three lilsts:<br />
:* Unassociated items (you arrive here by default) <br />
:* Associated items <br />
:* Hidden items (i.e., demos from MP you don't want associated with a product in CV)<br />
<br />
= <span style="color:#00528c">'''Common Issues'''</span> =<br />
<br />
== Message: "...We received some ANS data from marketplace on your behalf, but we cannot verify its authenticity...." ==<br />
<br />
This is due to an incomplete ANS feed setup. You have two options: <br />
<br />
1) You can add the Marketplace ANS notification salt to CasperVend<br />
<br />
or<br />
<br />
2) Remove the caspervend ANS URL from Marketplace <br />
<br />
== No Cross-Listing To/From Marketplace ==<br />
{{Information|This '''ONLY''' tracks sales data FROM Marketplace. You cannot send product listing information from CasperVend to Marketplace, or vice-versa. Linden Lab does NOT allow 3rd party access to its servers.}}<br />
<br />
You '''MUST''' set up your listings on each platform, manually. All the ANS method does is add '''SALES DATA''' from your Marketplace sales into your CasperVend FOR the corresponding products. <br />
<br />
The ANS method is a one-way information path. '''Sales data''' flows '''FROM''' Marketplace '''TO''' CasperVend, not the other way around.<br />
<br />
== Spend" on Marketplace versus "Spend" inworld ==<br />
If you have set up the Marketplace ANS feed properly, customer purchases ON Marketplace will accumulate towards the "spend" total for any loyalty options you have set up. <br />
<br />
However, any customer rewards you have set up will '''ONLY''' apply to purchases on inworld vendors.<br />
<br />
== Viewing Marketplace Statistics After ANS Set Up? ==<br />
<br />
They will appear in your CasperVend statistics page, as they happen, the same as your inworld transactions normally would. <br />
<br />
If you '''[[CasperVend_2/CSV_Import | import prior sales data]]''', then old should appear once you've completed the import and associated all the items. <br />
<br />
=== But all I see is "unknown" for the product name? ===<br />
----<br />
Then you need to go to the Overview tab, and next to where it says "3rd party sales association", you'll see a link that says "Associate Now" - click that link, you'll be taken to the association wizard, and you can tell/verify with CasperVend what Marketplace sales match up with which corresponding CasperVend product listings.<br />
<br />
= '''<span style="color:#00528c">FAQ / Troubleshooting</span>''' =<br />
: '''Q. Can I have the ANS data from MP on one SL account go to the CasperVend data of another SL account? '''<br />
:: '''A.''' Casper writes: "No, sorry, it's account tied." The SL account names have to match between CasperVend and Marketplace. <br />
<br />
: '''Q. I want to have CasperVend track all my MP sales but don't have any products in CasperVend. Can I do this?'''<br />
:: '''A.''' No, CasperVend is NOT designed to track purchases from Marketplace without having a matching product already set up in CasperVend. <br />
<br />
: '''Q. I've got a bunch of sales from "Unknown / Banned User" entries in my statistics - wtf?''' <br />
:: '''A.''' This just means that the names haven't been resolved yet. They should change from "Unknown / Banned" to an actual name within the next few days. It does '''not''' mean the user is banned from the system - if they were actually banned, the transaction would not complete.<br />
<br />
&nbsp;</div>24607dde-d704-4db7-afa0-d9edc17c926chttps://wiki.casperdns.com/index.php?title=CasperVend_2/DropBoxes&diff=15331CasperVend 2/DropBoxes2023-08-31T18:17:20Z<p>24607dde-d704-4db7-afa0-d9edc17c926c: /* On Different Regions */</p>
<hr />
<div>{|align=right<br />
|__TOC__<br />
|}<br />
<br />
<!---- Keywords: product server ----> <br />
<br />
[[File:German_flag.gif]] [[CasperVend 2/DropBoxes/DE | Schaue hier in Deutsch!]]<br />
<br />
= '''<span style="color:#00528c">About the DropBox</span>''' =<br />
<br />
=== Current Version ===<br />
----<br />
Current version information may be '''[[Current_Versions | seen here]]'''. It's always a good idea to keep your dropbox(es) up to date, since version changes are quite often working around new bugs in sim communications that can cause failed deliveries.<br />
<br />
=== Debit Permissions - Version 2.70 and up ===<br />
----<br />
* '''Dropboxes now ask for debit permissions''' and may now be used to make payments for vendor refunds.<br />
* When an outgoing payment is made, the transaction URL will now appear in your Second Life transaction history instead of the object name, to help with tracking and avoid confusion when different objects are used for payments (See '''[https://wiki.casperdns.com/images/e/e9/CV_transaction_URL.png this image]''' for example.)<br />
* The "URL" warning should no longer occur on region restart ('''unless''' legitimate)<br />
<br />
See '''[https://wiki.casperdns.com/index.php/CasperVend_2/Vendors/ChangeLog#Dropboxes_and_debit_permissions Vendor Changelog]''' and '''[https://wiki.casperdns.com/index.php/Debit_Permissions Debit Permissions]''' pages for details.<br />
<br />
'''You will need to remain ON THE SIM/REGION while you are updating to v2.70, because of the need to answer the debit permissions windows!'''<br />
<br />
=== Limits ===<br />
----<br />
We recommend keeping the number of items in a dropbox below 200, the approximate number most people are comfortable with while waiting for the contents to load, with 400 being an upper limit in extreme cases. There have been issues reported with Second Life object inventories when people go substantially over these numbers.<br />
<br />
=== Moving / Returning DropBox ===<br />
----<br />
If your DropBox is accidentally returned to your inventory, simply rez it back out from your "Lost & Found" folder. No additional action needs to be taken once the DropBox is rezzed out once more; the site will pick up the contents automatically. <br />
<br />
If you need to move, simply follow these steps: <br />
:# Right-click DropBox<br />
:# Select "Take a copy" <br />
:# Click DropBox again<br />
:# Select "Delete" from popup menu<br />
:# Confirm delete (This will flush contents from website cache) <br />
:# Go to new location<br />
:# Rez copy of DropBox <br />
:# All set! <br />
<br />
=== Must Stay Rezzed ===<br />
----<br />
Your dropbox must be rezzed out - inworld - '''AT ALL TIMES''' or it cannot deliver your products, notecards, etc. to your customers.<br />
<br />
'''Remember:''' All Scripted delivery objects will not function if you do not rez them under the proper land group (when it is group land). DropBoxes are no exception. <br />
<br />
=== Placement ===<br />
----<br />
It doesn't matter where you put your DropBox. However, there are certain caveats you should be aware of:<br />
<br />
:# The land must let YOU run scripts - either enabled for all, or you are in the land group.<br />
:# You must have continual access, in order to add/remove products.<br />
<br />
=== Public or Private Land? ===<br />
----<br />
Other people cannot edit your dropboxes (unless you've given them "mod rights" on your stuff), so public locations are perfectly safe.<br />
<br />
However, please read the rental agreement / land covenant FOR that location so make sure dropboxes in general are allowed - because land managers/owners can still return objects, even if they can't do anything else to them. <br />
<br />
=== Renaming Your DropBoxes ===<br />
----<br />
By default, the "physical" name of your dropbox is something like:<br />
<br />
CasperVend DropBox v((version #))<br />
<br />
It's not only ok to rename your DropBox, it is '''strongly recommended''' - at least to include YOUR store name. The name of the DropBox your product comes from is seen in the delivery message that the customer receives - so be aware of that when renaming the box.<br />
<br />
Renaming is also recommended because if someone mutes "CasperVend DropBox v((version #))" from someone else, and YOUR DropBox name matches that, yours will get caught in that muting as well. <br />
<br />
=== Seeing your DropBoxes ===<br />
----<br />
<br />
DropBoxes are now listed on the CasperVend website, on the '''[https://caspervend.casperdns.com/dropboxes.php DropBoxes]''' page. <br />
<br />
This page shows you: <br />
:# Name of the DropBox <br />
:# Version number<br />
:# Sim location (clickable link to location inworld) <br />
:# Last contacted<br />
:# # of items in the DropBox<br />
:# Option to '''manage''' that specific DropBox and see the '''contents" <br />
<br />
At the top of that page you can also list "10, 20, 50, 100 or All" of your DropBoxes at once. The default is 10 per page.<br />
<br />
=== DropBox Address Message ===<br />
----<br />
<br />
The DropBox that responds to a request to deliver an object will send its physical location with the delivery message. <br />
<br />
This is a grid limitation by the Lindens and cannot be changed via scripting. This was instituted several years ago by the Lindens as an anti-griefing measure, to make it easier to report the location of a griefing object, and it applies to ALL objects across the grid that send messages. <br />
<br />
While you don't have to keep your DropBox in your store or rental headquarters, keep in mind that the occasional customer may unexpectedly drop in where the DropBox is located if they click the address link. You can set up a security orb (or banlines) if you wish on a '''private''' location, or just relocate the box(es) to a location where you don't mind customers occasionally dropping in.<br />
<br />
= '''<span style="color:#00528c">Using Your DropBox</span>''' =<br />
''The DropBox only '''seems''' no-modify in your inventory. This is due to the DropBox script being no-modify. Once you rez it out, the prim WILL be modifiable and allow you to add contents.''<br />
<br />
== '''<span style="color:#00528c">Organising Your Items</span>''' ==<br />
How you organize your DropBox contents is ENTIRELY up to you.<br />
<br />
:*It doesn't matter which items are in which box<br />
:*It doesn't matter where your box is in Second Life (caveats: see '''[[#DropBox_placement|Placement]]''').<br />
:* '''[[CasperVend_2/DropBoxes#Setting_Up_Duplicate_DropBoxes | Duplicate sets]]''' are always recommended<br />
<br />
There is one organisational limitation that you must always remember:<br />
<br />
:*Be careful to give '''all items''' a unique name. For example, '''don't''' name a texture the same as one of your items - If you have two different items with the exact same name (in different DropBoxes), the system '''may assume''' it is a second copy of the first item and may deliver ''either one''!<br />
<br />
And yes, capitalisation and typos count!<br />
<br />
== '''<span style="color:#00528c">CasperLet Specific Information</span>''' ==<br />
<br />
The bulk of this page is written with CasperVend and CasperUpdate in mind. <br />
<br />
While the DropBox within the CasperLet crate is the same thing (with the same script) that's in the CasperVend and CasperUpdate crate, CasperLet itself only uses notecards and landmarks. <br />
<br />
If you '''only''' use CasperLet, understand that you will only be loading notecards and landmarks in your DropBox, despite references in most of this page to "products". <br />
<br />
== '''<span style="color:#00528c">Loading Your Dropbox</span>''' ==<br />
<br />
:#Rez the DropBox out<br />
:#Right-click on the DropBox<br />
:#Select "Edit", then go to "Contents" tab. <br />
:#Drag your packaged items, textures and any notecards you have ready into the dropbox.<br />
:#Make sure that your notecards / landmarks / textures / packaged items are all named differently - if you name a texture the same as your object, for example, the vendor system will deliver - or redeliver - '''one''' of '''either''' of them. This means that if your customer pays for a packaged product, and your texture has the exact same name as your packaged product, the customer may get the texture '''instead''' of the packaged product.<br />
<br />
=== Cannot Share DropBoxes ===<br />
----<br />
'''The DropBox only recognizes the owner that unpacked it from the shipping crate.''' <br />
<br />
You cannot "share with group", it will not load other people's products. You cannot deed to a group, because the DropBox is no transfer. (And even if you could, it wouldn't work - the group would then be the owner, and the group isn't the one that purchased the copy of CasperVend that the DropBox came from...)<br />
<br />
=== No Folders ===<br />
----<br />
DropBoxes '''CANNOT''' accept a folder AS a folder - it will always assume the contents of the folders are separate products. If you have multiple items for one product, they need to go in '''THEIR OWN''' box / bag / shipping crate / package before going in the dropbox. Do not put an object named NYAN into the DropBox or strange things may happen...<br />
<br />
=== Your DropBox won't let you add things? ===<br />
----<br />
The grid is known for occasionally not letting things work as well as they should. Here are some troubleshooting points if it doesn't seem like the DropBox is letting you put stuff in it: <br />
<br />
: # Did you "lock" the dropbox (maybe to prevent accidently deleting it)? <br />
: # Has everything in the dropbox fully loaded in the edit / contents window? (SL usually won't let you add things until everything is loaded)<br />
: # Is SL not letting you do other things either? (may need to relog...)<br />
: # Try CTL + dragging the item from your inventory to the DropBox.<br />
: # Is it round or a box? If it's round, you've grabbed the "UpgradeBee DROPBOXES ONLY" by mistake, and that will ALWAYS be no-mod. Search for '''"CasperTech DropBox"''' instead.<br />
<br />
=== "How do I connect the DropBox to...." ===<br />
----<br />
<br />
You don't. All the dropboxes work as inworld "cloud/pool storage" for deliveries - this is why duplicate sets are such a good idea. There's no need to even try to "pin" a dropbox to a specific vendor, the system will automatically pull a product for delivery from the first dropbox that (1) responds, and (2) HAS the item being requested.<br />
<br />
== '''<span style="color:#00528c">Updating Your DropBox</span>''' ==<br />
<br />
=== Updating With New Products ===<br />
----<br />
The SL grid does not allow one object to load inventory into another object in a different sim/region. You must manually add each of your new packaged products to '''EACH''' DropBox you want them to be in. "Cloud/pool" only applies to '''deliveries''' for customer purchases.<br />
<br />
=== Updating DropBox Version ===<br />
----<br />
See '''[[CasperVend_2/DropBoxes#Upgrading_Your_DropBoxes | this section]]'''<br />
<br />
== '''<span style="color:#00528c">Products Not Showing On Site?</span>''' ==<br />
There are '''four''' common principles behind why product packages may not show up on the website to be added to a new listing. They are: <br />
<br />
: 1) DropBox cannot be contacted<br />
: 2) Duplicated name of notecard/texture/etc. <br />
: 3) Product is "(no transfer)" to YOU, the merchant-owner<br />
: 4) Product is not in the dropbox<br />
<br />
There is also one big reason why product packages don't show on the '''PRODUCTS''' page itself, '''OR''' in the list of products to add to a profile: <br />
: 5) Products have not had a '''[[CasperVend_2/Product_Options | product listing]]''' created yet<br />
<br />
=== Can't be contacted ===<br />
----<br />
Common error points when the DropBox(es) can't be contacted are: <br />
# DropBox(es) not rezzed out (Like all scripted inworld delivery systems, they cannot deliver if not rezzed out...) <br />
# DropBox(es) has no script (need "CasperTech Dropbox" script to stay in the box) <br />
# The sim the DropBox(es) is(are) on is having a snit and not talking to the outside world (the "gone dark" issue mentioned in the backup section below) <br />
<br />
=== Duplicated Names ===<br />
----<br />
Common error is that the product name exactly matches the name of a texture or notecard. <br />
<br />
The popup for product selection is set to filter out duplicates - so this results in new products not showing because the texture or notecard is showing instead. <br />
<br />
# Rename your product package, corresponding notecard, and corresponding texture so that the names are '''ALL''' different from each other.<br />
<br />
=== Product is "no transfer" ===<br />
----<br />
Products MAY end up being effectively "(no transfer)" to you for different reasons: <br />
# Putting a holo demo in the DropBox instead of the holovendor<br />
# An errant script, texture, or other "(no transfer)" item included with the product by accident. (Might be accidentally linked to a build, or accidentally dropped in the contents of a prim.)<br />
<br />
Verify that all your items are transferable TO YOU by looking in the contents of (each) DropBox, waiting for the contents to load, and scrolling the list to the right to see the permissions. Scroll down to see everything in the DropBox and verify whether or not "(no transfer)" is next to any of the items.<br />
<br />
=== Not in the dropbox ===<br />
----<br />
# Did you forget to put it in the dropbox? <br />
# Did you perhaps put the product in the vendor instead of the DropBox?<br />
# When you rezzed (or re-rezzed) the DropBox, did you rez an older version that's missing the new item(s)?<br />
<br />
== '''<span style="color:#00528c">Products Not Showing On Products Page? </span>''' ==<br />
<br />
You won't see '''anything''' on the product page until a listing has been created for the product(s) in question. <br />
<br />
CasperVend does not show product '''packages''' on the '''[https://caspervend.casperdns.com/productsNew.php Products page]''', only completed product '''listings'''. <br />
<br />
You must create your product listings - if all goes well (see previous section for common troubleshooting points) then you'll see your missing packages in the popup for selecting a package to deliver, once you start creating your product listing. <br />
<br />
Start at #9 '''[[CasperVend_2/Quick_Start | on this page]]''' to create your product listings.<br />
<br />
=== Product Selector Popup Not Appearing On Website? ===<br />
----<br />
You may have a browser extension that's blocking the popup product picker window. <br />
<br />
If you are using Chrome, you can start another Chrome window in 'Incognito" mode - use CTL + SHFT + N to start an Incognito window. This disables all the extensions before logging you in. <br />
<br />
If you are using Firefox (or another browser) with a a "no javascript" type extension that allows a temporary override, you need to allow '''casperdns.com''' and '''ajax.googleapis.com''' to be able to see the product picker popup window.<br />
<br />
= '''<span style="color:#00528c">Upgrading Your DropBoxes</span>''' =<br />
:# Verify version: Click the DropBox, and from the popup menu, select "Version".<br />
:# Compare with the list on the '''[[Current_Versions | versions page]]'''.<br />
:# If your DropBox is out of date, '''redeliver''' the pack that your dropbox came from. (Old Bee only has old version.)<br />
:# Once you have a redelivered shipping crate, unpack that.<br />
:# Pull out the '''NEW''' UpgradeBee DROPBOXES ONLY.<br />
:# Rez one in each sim/region you have DropBox(es), and select '''RUN UPDATE'''. <br />
:# The UpgradeBee will fly around and update all of your DropBox(es).<br />
<br />
If you get an error message for "Illegal Task" '''or''' "0 attempted / 0 upgraded / 0 no longer exist / 0 weren't upgraded because..." message, then click the dropbox, and from the popup menu, select "Reset". <br />
<br />
=== "I Don't Have That Many Vendors Out!" ===<br />
----<br />
When you use the "check all" function, it will check '''everyone's''' vendors AND dropboxes on the sim. <br />
<br />
This is normal! <br />
<br />
It cannot actually upgrade anything that's not YOURS - but it will ping CasperVend things from everyone on the sim and see if the items are still rezzed out. <br />
<br />
=== Verifying the update worked ===<br />
----<br />
:* Click the DropBox. <br />
:* Select "Version" from the popup.<br />
:* (If you don't have "version" as an option, they need to be upgraded...) <br />
:* The DropBox will tell you its version in local chat. <br />
<br />
The DropBox '''prim''' will not be renamed by the UpgradeBee - this is normal. If you want the object name to reflect the version, you must rename it manually.<br />
<br />
= '''<span style="color:#00528c">Delivery Errors</span>''' =<br />
<br />
See the '''[[CasperVend_2/Deliveries#Delivery_Errors | delivery errors section]]''' on the transactions page.<br />
<br />
= '''<span style="color:#00528c">E-Mail Self Test Yellow Text Message</span>''' =<br />
:: '''''WARNING: This dropbox failed its e-mail self-test. This means that the box may become uncontactable, which may affect your deliveries. Please pick up this box and re-rez it.'''''<br />
<br />
This is a test feature new with version 2.27 - it's designed to let you know when the sim has blacklisted the dropbox in question. <br />
<br />
Make sure your DropBox is on the '''[[Current_Versions | latest version.]]''' If it's not, then follow '''[[CasperVend_2/DropBoxes#Updating_DropBox_Version | these instructions]]''' to get it up to date.<br />
<br />
This message '''has been removed in current versions.''' If you see any variant of this message, it means your DropBox is '''NOT''' up to date!<br />
<br />
= '''<span style="color:#00528c">Cleanly Deleting Old DropBoxes</span>''' =<br />
'''Properly''' deleting an older (or unused) DropBox is '''essential''' for a cleaner database - following these steps means that the DropBox will flush its contents out of the database before deleting itself. <br />
<br />
'''Remember to "take a copy" FIRST!'''<br />
<br />
# Click the DropBox<br />
# Select "Delete" from the popup menu<br />
# The DropBox will give you a confirmation screen; if you really want to delete it, click the appropriate option<br />
# The DropBox will clear its contents out of the website, before deleting itself inworld<br />
<br />
=== Products Showing That No Longer Exist? ===<br />
----<br />
This issue is most often caused by simply using "Edit > Delete" on an existing DropBox, '''OR''' a DropBox is accidentally returned to your lost & found folder. <br />
<br />
Here's the way to fix this: <br />
<br />
:# Log in to the CasperVend website<br />
:# Go to the '''[https://caspervend.casperdns.com/dropboxes.php DropBoxes page]'''<br />
:# You will see a list of all the DropBoxes the system thinks are still rezzed inworld. <br />
:# Click the '''"contents"''' link next to each dropbox and look through the contents<br />
:# When you find the incorrect dropbox, click '''"Manage"''' on the same line<br />
:# You will be taken to another page<br />
:# To delete that dropbox, select '''"Delete Unit"'''<br />
:# You will get a confirmation popup - click "ok"<br />
:# The system will process, and then reload the main DropBoxes page<br />
<br />
=== Accidentally Returned/Picked Up ===<br />
----<br />
Simply re-rez the DropBox. Your vendors will resume normal delivery operations without needing to touch anything on the website.<br />
<br />
= '''<span style="color:#00528c">The "DropBox Cloud"</span>''' =<br />
<br />
All DropBox(es) you have rezzed anywhere on the grid contribute to the "global product cloud" of your products. This is why it doesn't matter where you're dropboxes are, as long as they are rezzed inworld. <br />
<br />
The website will deliver '''one''' copy of the configured item, from '''the first available''' DropBox that has that product, AND responds in a timely manner. Due to general grid crappiness, sometimes a sim/region doesn't respond as well as it should - and having duplicates on different sims/regions means that the website has the opportunity to use other dropboxes for the delivery of that item instead of completely failing. <br />
<br />
So yes, multiple / duplicate / backup DropBox(es) are not only totally ok, they are actually encouraged!<br />
<br />
== '''<span style="color:#00528c">Setting Up Duplicate DropBoxes</span>''' ==<br />
You may think "backup sets", but it's really "duplicate sets" - the system does not seek out one set as a primary, the dropboxes send the product from (1) the first one to respond to the deliver command, that (2) has the product. If that's on your home sim, then that's where it comes from. If the first one to respond is one of your duplicated locations, then that's where it gets sent from. <br />
<br />
If you like, and you have multiple locations for your DropBoxes, you can work with ONE set as a "master set" of DropBoxes. Then, when you are done adding things in a particular session, simply do the following steps: <br />
<br />
# Right-click, then "Take a copy" of your existing DropBox(es)<br />
# Go to another sim/region where you have long-term rez rights. (If you're Premium and have a free parcel allowance, this would also be an ideal location. Please note that dropboxes are not allowed on Linden Homes, and please always check the covenant of the land you're using.) <br />
# Rez out the DropBox(es)<br />
# Wait for the DropBox(es) to talk to the website. <br />
# All set! Remember to leave the DropBox(es) rezzed at all times. <br />
<br />
You may organize your DropBoxes however you'd like, and you can rez however many you'd like (up to the maxmium prim/impact limits of the parcel, of course). <br />
<br />
=== Updating Duplicate DropBox(es) ===<br />
----<br />
If you want the products in all of your DropBox(es) to stay updated compared to each other, you will, unfortunately, need to do that manually. <br />
<br />
You can "designate" one set of DropBox(es) as your "master set" - this is NOT a scripted setting, and NOT something you do on the website, but in this case simply refers to the set that you update FIRST - whether you have it on your build platform (and set up an orb to keep random people from dropping in) or hanging out in your store is up to you. <br />
<br />
There are two ways of doing this: <br />
<br />
==== Adding Individual New Products ====<br />
----<br />
<br />
:# Go to each DropBox location<br />
:# Add the new product(s) to each pertinent DropBox<br />
<br />
If replacing old products, rather than just adding new: <br />
<br />
:# Go to each DropBox location<br />
:# Delete the old copy of the product you are replacing<br />
:# Replace with the new product<br />
<br />
Go around to all dropbox locations and add the new products to the pertinent DropBox(es) via Right-Click > Edit > Contents tab<br />
<br />
==== Replacing Older DropBox(es) ====<br />
---- <br />
<br />
:# Right-click > "Take a copy" of each dropbox that has been updated with new or replacement products <br />
:# Go to each additional DropBox location<br />
:# Delete the old copy rezzed out <br />
:# Replace with the new copy you just picked up <br />
:# Rez an upgradebee <br />
:# Wait for it to boot<br />
:# Click > select "Check All" <br />
:# Wait for it to run<br />
:# When it completes, simply delete the Bee<br />
<br />
You may see more numbers of objects it is checking than what you have/had rezzed out - this is normal, as a "check" will check ANYONE's, not just yours. It '''cannot''' do anything to anyone else's objects (and thus nobody else's upgrade bee can do anything to yours) - it just "pings" every CasperVend vendor or DropBox it knows WAS rezzed on the sim to see if it's still there.<br />
<br />
==== Last One Updated, First One Contacted ====<br />
----<br />
<br />
Usually, the last DropBox that gets updated with a new product is the one that the system tries to contact first.<br />
<br />
=== NOT On The Same Region ===<br />
----<br />
Having boxes containing the same item, on the '''same region''' is generally pointless. The goal behind having duplicate locations is to have reliability in case of sim/region-to-outside-world communication issues. Having all duplicate sets on the same sim/region means that they will all be affected when the sim/region goes out to lunch or runs out of URL's.<br />
<br />
=== On Different Regions ===<br />
----<br />
Having one or more duplicate DropBox(es) (DropBoxes containing the same items) on another region is '''HIGHLY recommended'''.<br />
<br />
Partly this is so that you have DropBoxes that work even when the simulator/region is down (especially if you have affiliate vendors out on the grid, or multiple locations) but also because simulators/regions occasionally "go dark" and refuse to talk to the outside world. The sim/region will still be up, inworld, and accessible to avatars even in this state, but because it's not talking to the outside world, DropBoxes on these affected sims/regions will be unable to deliver product to customers.<br />
<br />
Having one or more duplicate sets on other sims/regions reduces the chance that YOUR products won't deliver, when customers make a purchase, or redeliver (thus making customers think you are no longer active as a merchant). These backup locations can be friends' homes, etc. <br />
<br />
There are also [https://wiki.casperdns.com/index.php/DropBox_Hosting DropBox Hosting services on the grid] that will allow you to rent a few prims just for DropBox purposes.<br />
<br />
= '''<span style="color:#00528c">DropBox Page on Website</span>''' =<br />
Your DropBoxes are now listed on the website, on the [https://wiki.casperdns.com/index.php/CasperVend_2/DropBoxes DropBoxes page]!<br />
<br />
The list is "colour coded" according to how long it's been since the site last contacted the dropbox. It does '''NOT''' mean that it's broken - deliveries will still happen. If you're concerned that it's shown with a colour background other than white, you may click the dropbox inworld and select "reset" - that'll make it contact the website and turn it white. It is '''NOT''' required that you do that - not being contacted doesn't mean it's not working. <br />
<br />
== The Columns ==<br />
:'''Last Seen:''' This is how long it's been since the website last talked to the dropbox. <br />
:'''Version:''' This is the script-reported version of the dropbox. An easy way to tell when you need to [[Current_Versions | check your versions]]. <br />
:'''Location:''' This is the listing of the sim, with a SLURL to the exact location where the DropBox is inworld. <br />
:'''Actions:''' You can "Manage" or view the "Contents" of the dropbox from this column. "Manage" gives you a page where you can ping, update, or delete the dropbox. "Contents" just shows you what's in it.<br />
<br />
== Colour Coding ==<br />
Yellow is for not being contacted for a short time. Pink is for not being contacted for a longer time. <br />
<br />
The variations in yellow and pink do not represent any specific timeframe, they alternate lighter and darker to make it easier for your eyes to follow a specific line.<br />
<br />
= '''<span style="color:#00528c">FAQ / Troubleshooting</span>''' =<br />
<br />
: '''Q. Why'd my vendors suddenly stop delivering notecards / demos / products?'''<br />
:: '''A.''' Things cannot be delivered if the system cannot find the dropbox, and/or cannot find the product items it's been told to send. Therefore, the first points to check are: <br />
::: * Is the item IN the dropbox? <br />
::: * Is the site pointing to the correct item(s)<br />
::: * Have you recently change name on the product / notecard / demo, without updating the website? <br />
::: * Has the sim/region "gone dark"? (If so, the only solution is restart the sim and/or have backup copies on at least one other sim/region.) <br />
::: * How many items are in your dropbox? (Remember if there are too many things in the dropbox, the SL servers seem to make stuff "go missing" - which would also prevent delivery of items.) <br />
::: * Also compare YOUR transaction log with the information in the '''[[CasperVend_2/Deliveries | Transactions & Deliveries]]''' page.<br />
<br />
: '''Q. My customers aren't getting the product after purchase, and the redelivery terminal keeps giving them a "Failed: Couldn't find delivery box for item on SLIFE. This merchant may no longer be using CasperVend." message, when it is, and I am.'''<br />
:: '''A1.''' Reset the DropBox(es). Use the touch menu first - if that doesn't work, then manually Edit > Reset scripts in selection to get them to actually reset. <br />
:: '''A2.''' If you have DropBox(es) on only one sim/region, then we strongly recommend having a backup set (see above) on at least one other sim/region location to reduce the risk of this happening again. <br />
<br />
: '''Q. I have a DropBox which shows as 'live' and as having __ items listed. However, when I open the drop box there are maybe half that amount of items showing inside the box.'''<br />
:: '''A.''' Casper Warden writes: "basically, if items have disappeared from the box, there's two possible reasons...<br />
::: '''1)''' they were no copy and were delivered<br />
::: '''2)''' your sim suffered an inventory failure or rollback<br />
:: in both circumstances the system isn't notified about the change :/ " <br />
:: When items that are no-copy to the merchant (such as breedable things) get sold, the # in the floaty text above the dropbox does NOT get updated.<br />
<br />
:'''Q. I got this message: "CasperVend DropBox: Items in the database seem to be out of sync! Re-uploading."'''<br />
:: '''A.''' Nothing to worry about - the system's self-check has determined that there is lag, either on the sim/region or in the grid itself. Once or twice per DropBox is normal (if you have multiple DropBoxes, you'll get several messages, but should just be one or two from each.) <br />
:: The only time to worry is when you get the message several times a day - that would indicate a sim/region communication problem, or that Casper is working on the backend servers. <br />
<br />
:'''Q. My last shop location is no more, I don't have access to it, and it keeps trying to send the OLD landmark. How can I fix this? '''<br />
:: '''A1.''' You'll need to edit *everywhere* you have it marked - usually this is in each and every single product listing - and set them up with the new landmark. <br />
:: '''A2.''' It is STRONGLY RECOMMENDED that you use a landmark name like '''"(your shop) - Main location"''' - rather than the default LL format that includes the sim/region name. Renaming your landmarks to something simple and WITHOUT the sim/region name means that when you have to move in the future, you can just outright swap the landmarks, without having to go through the hassle of updating every single product every time you change landmarks. <br />
<br />
:'''Q. I keep getting messages of "That item is no longer available or doesn't belong to you." when it is, and it does. '''<br />
:: '''A.''' Pick up and re-rez the DropBox, that should get rid of the spurious errors.</div>24607dde-d704-4db7-afa0-d9edc17c926chttps://wiki.casperdns.com/index.php?title=CasperVend_2/DropBoxes&diff=15330CasperVend 2/DropBoxes2023-08-31T18:15:32Z<p>24607dde-d704-4db7-afa0-d9edc17c926c: /* On Different Regions */</p>
<hr />
<div>{|align=right<br />
|__TOC__<br />
|}<br />
<br />
<!---- Keywords: product server ----> <br />
<br />
[[File:German_flag.gif]] [[CasperVend 2/DropBoxes/DE | Schaue hier in Deutsch!]]<br />
<br />
= '''<span style="color:#00528c">About the DropBox</span>''' =<br />
<br />
=== Current Version ===<br />
----<br />
Current version information may be '''[[Current_Versions | seen here]]'''. It's always a good idea to keep your dropbox(es) up to date, since version changes are quite often working around new bugs in sim communications that can cause failed deliveries.<br />
<br />
=== Debit Permissions - Version 2.70 and up ===<br />
----<br />
* '''Dropboxes now ask for debit permissions''' and may now be used to make payments for vendor refunds.<br />
* When an outgoing payment is made, the transaction URL will now appear in your Second Life transaction history instead of the object name, to help with tracking and avoid confusion when different objects are used for payments (See '''[https://wiki.casperdns.com/images/e/e9/CV_transaction_URL.png this image]''' for example.)<br />
* The "URL" warning should no longer occur on region restart ('''unless''' legitimate)<br />
<br />
See '''[https://wiki.casperdns.com/index.php/CasperVend_2/Vendors/ChangeLog#Dropboxes_and_debit_permissions Vendor Changelog]''' and '''[https://wiki.casperdns.com/index.php/Debit_Permissions Debit Permissions]''' pages for details.<br />
<br />
'''You will need to remain ON THE SIM/REGION while you are updating to v2.70, because of the need to answer the debit permissions windows!'''<br />
<br />
=== Limits ===<br />
----<br />
We recommend keeping the number of items in a dropbox below 200, the approximate number most people are comfortable with while waiting for the contents to load, with 400 being an upper limit in extreme cases. There have been issues reported with Second Life object inventories when people go substantially over these numbers.<br />
<br />
=== Moving / Returning DropBox ===<br />
----<br />
If your DropBox is accidentally returned to your inventory, simply rez it back out from your "Lost & Found" folder. No additional action needs to be taken once the DropBox is rezzed out once more; the site will pick up the contents automatically. <br />
<br />
If you need to move, simply follow these steps: <br />
:# Right-click DropBox<br />
:# Select "Take a copy" <br />
:# Click DropBox again<br />
:# Select "Delete" from popup menu<br />
:# Confirm delete (This will flush contents from website cache) <br />
:# Go to new location<br />
:# Rez copy of DropBox <br />
:# All set! <br />
<br />
=== Must Stay Rezzed ===<br />
----<br />
Your dropbox must be rezzed out - inworld - '''AT ALL TIMES''' or it cannot deliver your products, notecards, etc. to your customers.<br />
<br />
'''Remember:''' All Scripted delivery objects will not function if you do not rez them under the proper land group (when it is group land). DropBoxes are no exception. <br />
<br />
=== Placement ===<br />
----<br />
It doesn't matter where you put your DropBox. However, there are certain caveats you should be aware of:<br />
<br />
:# The land must let YOU run scripts - either enabled for all, or you are in the land group.<br />
:# You must have continual access, in order to add/remove products.<br />
<br />
=== Public or Private Land? ===<br />
----<br />
Other people cannot edit your dropboxes (unless you've given them "mod rights" on your stuff), so public locations are perfectly safe.<br />
<br />
However, please read the rental agreement / land covenant FOR that location so make sure dropboxes in general are allowed - because land managers/owners can still return objects, even if they can't do anything else to them. <br />
<br />
=== Renaming Your DropBoxes ===<br />
----<br />
By default, the "physical" name of your dropbox is something like:<br />
<br />
CasperVend DropBox v((version #))<br />
<br />
It's not only ok to rename your DropBox, it is '''strongly recommended''' - at least to include YOUR store name. The name of the DropBox your product comes from is seen in the delivery message that the customer receives - so be aware of that when renaming the box.<br />
<br />
Renaming is also recommended because if someone mutes "CasperVend DropBox v((version #))" from someone else, and YOUR DropBox name matches that, yours will get caught in that muting as well. <br />
<br />
=== Seeing your DropBoxes ===<br />
----<br />
<br />
DropBoxes are now listed on the CasperVend website, on the '''[https://caspervend.casperdns.com/dropboxes.php DropBoxes]''' page. <br />
<br />
This page shows you: <br />
:# Name of the DropBox <br />
:# Version number<br />
:# Sim location (clickable link to location inworld) <br />
:# Last contacted<br />
:# # of items in the DropBox<br />
:# Option to '''manage''' that specific DropBox and see the '''contents" <br />
<br />
At the top of that page you can also list "10, 20, 50, 100 or All" of your DropBoxes at once. The default is 10 per page.<br />
<br />
=== DropBox Address Message ===<br />
----<br />
<br />
The DropBox that responds to a request to deliver an object will send its physical location with the delivery message. <br />
<br />
This is a grid limitation by the Lindens and cannot be changed via scripting. This was instituted several years ago by the Lindens as an anti-griefing measure, to make it easier to report the location of a griefing object, and it applies to ALL objects across the grid that send messages. <br />
<br />
While you don't have to keep your DropBox in your store or rental headquarters, keep in mind that the occasional customer may unexpectedly drop in where the DropBox is located if they click the address link. You can set up a security orb (or banlines) if you wish on a '''private''' location, or just relocate the box(es) to a location where you don't mind customers occasionally dropping in.<br />
<br />
= '''<span style="color:#00528c">Using Your DropBox</span>''' =<br />
''The DropBox only '''seems''' no-modify in your inventory. This is due to the DropBox script being no-modify. Once you rez it out, the prim WILL be modifiable and allow you to add contents.''<br />
<br />
== '''<span style="color:#00528c">Organising Your Items</span>''' ==<br />
How you organize your DropBox contents is ENTIRELY up to you.<br />
<br />
:*It doesn't matter which items are in which box<br />
:*It doesn't matter where your box is in Second Life (caveats: see '''[[#DropBox_placement|Placement]]''').<br />
:* '''[[CasperVend_2/DropBoxes#Setting_Up_Duplicate_DropBoxes | Duplicate sets]]''' are always recommended<br />
<br />
There is one organisational limitation that you must always remember:<br />
<br />
:*Be careful to give '''all items''' a unique name. For example, '''don't''' name a texture the same as one of your items - If you have two different items with the exact same name (in different DropBoxes), the system '''may assume''' it is a second copy of the first item and may deliver ''either one''!<br />
<br />
And yes, capitalisation and typos count!<br />
<br />
== '''<span style="color:#00528c">CasperLet Specific Information</span>''' ==<br />
<br />
The bulk of this page is written with CasperVend and CasperUpdate in mind. <br />
<br />
While the DropBox within the CasperLet crate is the same thing (with the same script) that's in the CasperVend and CasperUpdate crate, CasperLet itself only uses notecards and landmarks. <br />
<br />
If you '''only''' use CasperLet, understand that you will only be loading notecards and landmarks in your DropBox, despite references in most of this page to "products". <br />
<br />
== '''<span style="color:#00528c">Loading Your Dropbox</span>''' ==<br />
<br />
:#Rez the DropBox out<br />
:#Right-click on the DropBox<br />
:#Select "Edit", then go to "Contents" tab. <br />
:#Drag your packaged items, textures and any notecards you have ready into the dropbox.<br />
:#Make sure that your notecards / landmarks / textures / packaged items are all named differently - if you name a texture the same as your object, for example, the vendor system will deliver - or redeliver - '''one''' of '''either''' of them. This means that if your customer pays for a packaged product, and your texture has the exact same name as your packaged product, the customer may get the texture '''instead''' of the packaged product.<br />
<br />
=== Cannot Share DropBoxes ===<br />
----<br />
'''The DropBox only recognizes the owner that unpacked it from the shipping crate.''' <br />
<br />
You cannot "share with group", it will not load other people's products. You cannot deed to a group, because the DropBox is no transfer. (And even if you could, it wouldn't work - the group would then be the owner, and the group isn't the one that purchased the copy of CasperVend that the DropBox came from...)<br />
<br />
=== No Folders ===<br />
----<br />
DropBoxes '''CANNOT''' accept a folder AS a folder - it will always assume the contents of the folders are separate products. If you have multiple items for one product, they need to go in '''THEIR OWN''' box / bag / shipping crate / package before going in the dropbox. Do not put an object named NYAN into the DropBox or strange things may happen...<br />
<br />
=== Your DropBox won't let you add things? ===<br />
----<br />
The grid is known for occasionally not letting things work as well as they should. Here are some troubleshooting points if it doesn't seem like the DropBox is letting you put stuff in it: <br />
<br />
: # Did you "lock" the dropbox (maybe to prevent accidently deleting it)? <br />
: # Has everything in the dropbox fully loaded in the edit / contents window? (SL usually won't let you add things until everything is loaded)<br />
: # Is SL not letting you do other things either? (may need to relog...)<br />
: # Try CTL + dragging the item from your inventory to the DropBox.<br />
: # Is it round or a box? If it's round, you've grabbed the "UpgradeBee DROPBOXES ONLY" by mistake, and that will ALWAYS be no-mod. Search for '''"CasperTech DropBox"''' instead.<br />
<br />
=== "How do I connect the DropBox to...." ===<br />
----<br />
<br />
You don't. All the dropboxes work as inworld "cloud/pool storage" for deliveries - this is why duplicate sets are such a good idea. There's no need to even try to "pin" a dropbox to a specific vendor, the system will automatically pull a product for delivery from the first dropbox that (1) responds, and (2) HAS the item being requested.<br />
<br />
== '''<span style="color:#00528c">Updating Your DropBox</span>''' ==<br />
<br />
=== Updating With New Products ===<br />
----<br />
The SL grid does not allow one object to load inventory into another object in a different sim/region. You must manually add each of your new packaged products to '''EACH''' DropBox you want them to be in. "Cloud/pool" only applies to '''deliveries''' for customer purchases.<br />
<br />
=== Updating DropBox Version ===<br />
----<br />
See '''[[CasperVend_2/DropBoxes#Upgrading_Your_DropBoxes | this section]]'''<br />
<br />
== '''<span style="color:#00528c">Products Not Showing On Site?</span>''' ==<br />
There are '''four''' common principles behind why product packages may not show up on the website to be added to a new listing. They are: <br />
<br />
: 1) DropBox cannot be contacted<br />
: 2) Duplicated name of notecard/texture/etc. <br />
: 3) Product is "(no transfer)" to YOU, the merchant-owner<br />
: 4) Product is not in the dropbox<br />
<br />
There is also one big reason why product packages don't show on the '''PRODUCTS''' page itself, '''OR''' in the list of products to add to a profile: <br />
: 5) Products have not had a '''[[CasperVend_2/Product_Options | product listing]]''' created yet<br />
<br />
=== Can't be contacted ===<br />
----<br />
Common error points when the DropBox(es) can't be contacted are: <br />
# DropBox(es) not rezzed out (Like all scripted inworld delivery systems, they cannot deliver if not rezzed out...) <br />
# DropBox(es) has no script (need "CasperTech Dropbox" script to stay in the box) <br />
# The sim the DropBox(es) is(are) on is having a snit and not talking to the outside world (the "gone dark" issue mentioned in the backup section below) <br />
<br />
=== Duplicated Names ===<br />
----<br />
Common error is that the product name exactly matches the name of a texture or notecard. <br />
<br />
The popup for product selection is set to filter out duplicates - so this results in new products not showing because the texture or notecard is showing instead. <br />
<br />
# Rename your product package, corresponding notecard, and corresponding texture so that the names are '''ALL''' different from each other.<br />
<br />
=== Product is "no transfer" ===<br />
----<br />
Products MAY end up being effectively "(no transfer)" to you for different reasons: <br />
# Putting a holo demo in the DropBox instead of the holovendor<br />
# An errant script, texture, or other "(no transfer)" item included with the product by accident. (Might be accidentally linked to a build, or accidentally dropped in the contents of a prim.)<br />
<br />
Verify that all your items are transferable TO YOU by looking in the contents of (each) DropBox, waiting for the contents to load, and scrolling the list to the right to see the permissions. Scroll down to see everything in the DropBox and verify whether or not "(no transfer)" is next to any of the items.<br />
<br />
=== Not in the dropbox ===<br />
----<br />
# Did you forget to put it in the dropbox? <br />
# Did you perhaps put the product in the vendor instead of the DropBox?<br />
# When you rezzed (or re-rezzed) the DropBox, did you rez an older version that's missing the new item(s)?<br />
<br />
== '''<span style="color:#00528c">Products Not Showing On Products Page? </span>''' ==<br />
<br />
You won't see '''anything''' on the product page until a listing has been created for the product(s) in question. <br />
<br />
CasperVend does not show product '''packages''' on the '''[https://caspervend.casperdns.com/productsNew.php Products page]''', only completed product '''listings'''. <br />
<br />
You must create your product listings - if all goes well (see previous section for common troubleshooting points) then you'll see your missing packages in the popup for selecting a package to deliver, once you start creating your product listing. <br />
<br />
Start at #9 '''[[CasperVend_2/Quick_Start | on this page]]''' to create your product listings.<br />
<br />
=== Product Selector Popup Not Appearing On Website? ===<br />
----<br />
You may have a browser extension that's blocking the popup product picker window. <br />
<br />
If you are using Chrome, you can start another Chrome window in 'Incognito" mode - use CTL + SHFT + N to start an Incognito window. This disables all the extensions before logging you in. <br />
<br />
If you are using Firefox (or another browser) with a a "no javascript" type extension that allows a temporary override, you need to allow '''casperdns.com''' and '''ajax.googleapis.com''' to be able to see the product picker popup window.<br />
<br />
= '''<span style="color:#00528c">Upgrading Your DropBoxes</span>''' =<br />
:# Verify version: Click the DropBox, and from the popup menu, select "Version".<br />
:# Compare with the list on the '''[[Current_Versions | versions page]]'''.<br />
:# If your DropBox is out of date, '''redeliver''' the pack that your dropbox came from. (Old Bee only has old version.)<br />
:# Once you have a redelivered shipping crate, unpack that.<br />
:# Pull out the '''NEW''' UpgradeBee DROPBOXES ONLY.<br />
:# Rez one in each sim/region you have DropBox(es), and select '''RUN UPDATE'''. <br />
:# The UpgradeBee will fly around and update all of your DropBox(es).<br />
<br />
If you get an error message for "Illegal Task" '''or''' "0 attempted / 0 upgraded / 0 no longer exist / 0 weren't upgraded because..." message, then click the dropbox, and from the popup menu, select "Reset". <br />
<br />
=== "I Don't Have That Many Vendors Out!" ===<br />
----<br />
When you use the "check all" function, it will check '''everyone's''' vendors AND dropboxes on the sim. <br />
<br />
This is normal! <br />
<br />
It cannot actually upgrade anything that's not YOURS - but it will ping CasperVend things from everyone on the sim and see if the items are still rezzed out. <br />
<br />
=== Verifying the update worked ===<br />
----<br />
:* Click the DropBox. <br />
:* Select "Version" from the popup.<br />
:* (If you don't have "version" as an option, they need to be upgraded...) <br />
:* The DropBox will tell you its version in local chat. <br />
<br />
The DropBox '''prim''' will not be renamed by the UpgradeBee - this is normal. If you want the object name to reflect the version, you must rename it manually.<br />
<br />
= '''<span style="color:#00528c">Delivery Errors</span>''' =<br />
<br />
See the '''[[CasperVend_2/Deliveries#Delivery_Errors | delivery errors section]]''' on the transactions page.<br />
<br />
= '''<span style="color:#00528c">E-Mail Self Test Yellow Text Message</span>''' =<br />
:: '''''WARNING: This dropbox failed its e-mail self-test. This means that the box may become uncontactable, which may affect your deliveries. Please pick up this box and re-rez it.'''''<br />
<br />
This is a test feature new with version 2.27 - it's designed to let you know when the sim has blacklisted the dropbox in question. <br />
<br />
Make sure your DropBox is on the '''[[Current_Versions | latest version.]]''' If it's not, then follow '''[[CasperVend_2/DropBoxes#Updating_DropBox_Version | these instructions]]''' to get it up to date.<br />
<br />
This message '''has been removed in current versions.''' If you see any variant of this message, it means your DropBox is '''NOT''' up to date!<br />
<br />
= '''<span style="color:#00528c">Cleanly Deleting Old DropBoxes</span>''' =<br />
'''Properly''' deleting an older (or unused) DropBox is '''essential''' for a cleaner database - following these steps means that the DropBox will flush its contents out of the database before deleting itself. <br />
<br />
'''Remember to "take a copy" FIRST!'''<br />
<br />
# Click the DropBox<br />
# Select "Delete" from the popup menu<br />
# The DropBox will give you a confirmation screen; if you really want to delete it, click the appropriate option<br />
# The DropBox will clear its contents out of the website, before deleting itself inworld<br />
<br />
=== Products Showing That No Longer Exist? ===<br />
----<br />
This issue is most often caused by simply using "Edit > Delete" on an existing DropBox, '''OR''' a DropBox is accidentally returned to your lost & found folder. <br />
<br />
Here's the way to fix this: <br />
<br />
:# Log in to the CasperVend website<br />
:# Go to the '''[https://caspervend.casperdns.com/dropboxes.php DropBoxes page]'''<br />
:# You will see a list of all the DropBoxes the system thinks are still rezzed inworld. <br />
:# Click the '''"contents"''' link next to each dropbox and look through the contents<br />
:# When you find the incorrect dropbox, click '''"Manage"''' on the same line<br />
:# You will be taken to another page<br />
:# To delete that dropbox, select '''"Delete Unit"'''<br />
:# You will get a confirmation popup - click "ok"<br />
:# The system will process, and then reload the main DropBoxes page<br />
<br />
=== Accidentally Returned/Picked Up ===<br />
----<br />
Simply re-rez the DropBox. Your vendors will resume normal delivery operations without needing to touch anything on the website.<br />
<br />
= '''<span style="color:#00528c">The "DropBox Cloud"</span>''' =<br />
<br />
All DropBox(es) you have rezzed anywhere on the grid contribute to the "global product cloud" of your products. This is why it doesn't matter where you're dropboxes are, as long as they are rezzed inworld. <br />
<br />
The website will deliver '''one''' copy of the configured item, from '''the first available''' DropBox that has that product, AND responds in a timely manner. Due to general grid crappiness, sometimes a sim/region doesn't respond as well as it should - and having duplicates on different sims/regions means that the website has the opportunity to use other dropboxes for the delivery of that item instead of completely failing. <br />
<br />
So yes, multiple / duplicate / backup DropBox(es) are not only totally ok, they are actually encouraged!<br />
<br />
== '''<span style="color:#00528c">Setting Up Duplicate DropBoxes</span>''' ==<br />
You may think "backup sets", but it's really "duplicate sets" - the system does not seek out one set as a primary, the dropboxes send the product from (1) the first one to respond to the deliver command, that (2) has the product. If that's on your home sim, then that's where it comes from. If the first one to respond is one of your duplicated locations, then that's where it gets sent from. <br />
<br />
If you like, and you have multiple locations for your DropBoxes, you can work with ONE set as a "master set" of DropBoxes. Then, when you are done adding things in a particular session, simply do the following steps: <br />
<br />
# Right-click, then "Take a copy" of your existing DropBox(es)<br />
# Go to another sim/region where you have long-term rez rights. (If you're Premium and have a free parcel allowance, this would also be an ideal location. Please note that dropboxes are not allowed on Linden Homes, and please always check the covenant of the land you're using.) <br />
# Rez out the DropBox(es)<br />
# Wait for the DropBox(es) to talk to the website. <br />
# All set! Remember to leave the DropBox(es) rezzed at all times. <br />
<br />
You may organize your DropBoxes however you'd like, and you can rez however many you'd like (up to the maxmium prim/impact limits of the parcel, of course). <br />
<br />
=== Updating Duplicate DropBox(es) ===<br />
----<br />
If you want the products in all of your DropBox(es) to stay updated compared to each other, you will, unfortunately, need to do that manually. <br />
<br />
You can "designate" one set of DropBox(es) as your "master set" - this is NOT a scripted setting, and NOT something you do on the website, but in this case simply refers to the set that you update FIRST - whether you have it on your build platform (and set up an orb to keep random people from dropping in) or hanging out in your store is up to you. <br />
<br />
There are two ways of doing this: <br />
<br />
==== Adding Individual New Products ====<br />
----<br />
<br />
:# Go to each DropBox location<br />
:# Add the new product(s) to each pertinent DropBox<br />
<br />
If replacing old products, rather than just adding new: <br />
<br />
:# Go to each DropBox location<br />
:# Delete the old copy of the product you are replacing<br />
:# Replace with the new product<br />
<br />
Go around to all dropbox locations and add the new products to the pertinent DropBox(es) via Right-Click > Edit > Contents tab<br />
<br />
==== Replacing Older DropBox(es) ====<br />
---- <br />
<br />
:# Right-click > "Take a copy" of each dropbox that has been updated with new or replacement products <br />
:# Go to each additional DropBox location<br />
:# Delete the old copy rezzed out <br />
:# Replace with the new copy you just picked up <br />
:# Rez an upgradebee <br />
:# Wait for it to boot<br />
:# Click > select "Check All" <br />
:# Wait for it to run<br />
:# When it completes, simply delete the Bee<br />
<br />
You may see more numbers of objects it is checking than what you have/had rezzed out - this is normal, as a "check" will check ANYONE's, not just yours. It '''cannot''' do anything to anyone else's objects (and thus nobody else's upgrade bee can do anything to yours) - it just "pings" every CasperVend vendor or DropBox it knows WAS rezzed on the sim to see if it's still there.<br />
<br />
==== Last One Updated, First One Contacted ====<br />
----<br />
<br />
Usually, the last DropBox that gets updated with a new product is the one that the system tries to contact first.<br />
<br />
=== NOT On The Same Region ===<br />
----<br />
Having boxes containing the same item, on the '''same region''' is generally pointless. The goal behind having duplicate locations is to have reliability in case of sim/region-to-outside-world communication issues. Having all duplicate sets on the same sim/region means that they will all be affected when the sim/region goes out to lunch or runs out of URL's.<br />
<br />
=== On Different Regions ===<br />
----<br />
Having one or more duplicate DropBox(es) (DropBoxes containing the same items) on another region is '''HIGHLY recommended'''.<br />
<br />
Partly this is so that you have DropBoxes that work even when the simulator/region is down (especially if you have affiliate vendors out on the grid, or multiple locations) but also because simulators/regions occasionally "go dark" and refuse to talk to the outside world. The sim/region will still be up, inworld, and accessible to avatars even in this state, but because it's not talking to the outside world, DropBoxes on these affected sims/regions will be unable to deliver product to customers.<br />
<br />
Having one or more duplicate sets on other sims/regions reduces the chance that YOUR products won't deliver, when customers make a purchase, or redeliver (thus making customers think you are no longer active as a merchant). These backup locations can be friend's homes, etc. <br />
<br />
There are also [https://wiki.casperdns.com/index.php/DropBox_Hosting DropBox Hosting services on the grid] that will allow you to rent a few prims just for DropBox purposes.<br />
<br />
= '''<span style="color:#00528c">DropBox Page on Website</span>''' =<br />
Your DropBoxes are now listed on the website, on the [https://wiki.casperdns.com/index.php/CasperVend_2/DropBoxes DropBoxes page]!<br />
<br />
The list is "colour coded" according to how long it's been since the site last contacted the dropbox. It does '''NOT''' mean that it's broken - deliveries will still happen. If you're concerned that it's shown with a colour background other than white, you may click the dropbox inworld and select "reset" - that'll make it contact the website and turn it white. It is '''NOT''' required that you do that - not being contacted doesn't mean it's not working. <br />
<br />
== The Columns ==<br />
:'''Last Seen:''' This is how long it's been since the website last talked to the dropbox. <br />
:'''Version:''' This is the script-reported version of the dropbox. An easy way to tell when you need to [[Current_Versions | check your versions]]. <br />
:'''Location:''' This is the listing of the sim, with a SLURL to the exact location where the DropBox is inworld. <br />
:'''Actions:''' You can "Manage" or view the "Contents" of the dropbox from this column. "Manage" gives you a page where you can ping, update, or delete the dropbox. "Contents" just shows you what's in it.<br />
<br />
== Colour Coding ==<br />
Yellow is for not being contacted for a short time. Pink is for not being contacted for a longer time. <br />
<br />
The variations in yellow and pink do not represent any specific timeframe, they alternate lighter and darker to make it easier for your eyes to follow a specific line.<br />
<br />
= '''<span style="color:#00528c">FAQ / Troubleshooting</span>''' =<br />
<br />
: '''Q. Why'd my vendors suddenly stop delivering notecards / demos / products?'''<br />
:: '''A.''' Things cannot be delivered if the system cannot find the dropbox, and/or cannot find the product items it's been told to send. Therefore, the first points to check are: <br />
::: * Is the item IN the dropbox? <br />
::: * Is the site pointing to the correct item(s)<br />
::: * Have you recently change name on the product / notecard / demo, without updating the website? <br />
::: * Has the sim/region "gone dark"? (If so, the only solution is restart the sim and/or have backup copies on at least one other sim/region.) <br />
::: * How many items are in your dropbox? (Remember if there are too many things in the dropbox, the SL servers seem to make stuff "go missing" - which would also prevent delivery of items.) <br />
::: * Also compare YOUR transaction log with the information in the '''[[CasperVend_2/Deliveries | Transactions & Deliveries]]''' page.<br />
<br />
: '''Q. My customers aren't getting the product after purchase, and the redelivery terminal keeps giving them a "Failed: Couldn't find delivery box for item on SLIFE. This merchant may no longer be using CasperVend." message, when it is, and I am.'''<br />
:: '''A1.''' Reset the DropBox(es). Use the touch menu first - if that doesn't work, then manually Edit > Reset scripts in selection to get them to actually reset. <br />
:: '''A2.''' If you have DropBox(es) on only one sim/region, then we strongly recommend having a backup set (see above) on at least one other sim/region location to reduce the risk of this happening again. <br />
<br />
: '''Q. I have a DropBox which shows as 'live' and as having __ items listed. However, when I open the drop box there are maybe half that amount of items showing inside the box.'''<br />
:: '''A.''' Casper Warden writes: "basically, if items have disappeared from the box, there's two possible reasons...<br />
::: '''1)''' they were no copy and were delivered<br />
::: '''2)''' your sim suffered an inventory failure or rollback<br />
:: in both circumstances the system isn't notified about the change :/ " <br />
:: When items that are no-copy to the merchant (such as breedable things) get sold, the # in the floaty text above the dropbox does NOT get updated.<br />
<br />
:'''Q. I got this message: "CasperVend DropBox: Items in the database seem to be out of sync! Re-uploading."'''<br />
:: '''A.''' Nothing to worry about - the system's self-check has determined that there is lag, either on the sim/region or in the grid itself. Once or twice per DropBox is normal (if you have multiple DropBoxes, you'll get several messages, but should just be one or two from each.) <br />
:: The only time to worry is when you get the message several times a day - that would indicate a sim/region communication problem, or that Casper is working on the backend servers. <br />
<br />
:'''Q. My last shop location is no more, I don't have access to it, and it keeps trying to send the OLD landmark. How can I fix this? '''<br />
:: '''A1.''' You'll need to edit *everywhere* you have it marked - usually this is in each and every single product listing - and set them up with the new landmark. <br />
:: '''A2.''' It is STRONGLY RECOMMENDED that you use a landmark name like '''"(your shop) - Main location"''' - rather than the default LL format that includes the sim/region name. Renaming your landmarks to something simple and WITHOUT the sim/region name means that when you have to move in the future, you can just outright swap the landmarks, without having to go through the hassle of updating every single product every time you change landmarks. <br />
<br />
:'''Q. I keep getting messages of "That item is no longer available or doesn't belong to you." when it is, and it does. '''<br />
:: '''A.''' Pick up and re-rez the DropBox, that should get rid of the spurious errors.</div>24607dde-d704-4db7-afa0-d9edc17c926chttps://wiki.casperdns.com/index.php?title=CasperVend_2/DropBoxes&diff=15329CasperVend 2/DropBoxes2023-08-31T18:15:02Z<p>24607dde-d704-4db7-afa0-d9edc17c926c: /* On Different Regions */</p>
<hr />
<div>{|align=right<br />
|__TOC__<br />
|}<br />
<br />
<!---- Keywords: product server ----> <br />
<br />
[[File:German_flag.gif]] [[CasperVend 2/DropBoxes/DE | Schaue hier in Deutsch!]]<br />
<br />
= '''<span style="color:#00528c">About the DropBox</span>''' =<br />
<br />
=== Current Version ===<br />
----<br />
Current version information may be '''[[Current_Versions | seen here]]'''. It's always a good idea to keep your dropbox(es) up to date, since version changes are quite often working around new bugs in sim communications that can cause failed deliveries.<br />
<br />
=== Debit Permissions - Version 2.70 and up ===<br />
----<br />
* '''Dropboxes now ask for debit permissions''' and may now be used to make payments for vendor refunds.<br />
* When an outgoing payment is made, the transaction URL will now appear in your Second Life transaction history instead of the object name, to help with tracking and avoid confusion when different objects are used for payments (See '''[https://wiki.casperdns.com/images/e/e9/CV_transaction_URL.png this image]''' for example.)<br />
* The "URL" warning should no longer occur on region restart ('''unless''' legitimate)<br />
<br />
See '''[https://wiki.casperdns.com/index.php/CasperVend_2/Vendors/ChangeLog#Dropboxes_and_debit_permissions Vendor Changelog]''' and '''[https://wiki.casperdns.com/index.php/Debit_Permissions Debit Permissions]''' pages for details.<br />
<br />
'''You will need to remain ON THE SIM/REGION while you are updating to v2.70, because of the need to answer the debit permissions windows!'''<br />
<br />
=== Limits ===<br />
----<br />
We recommend keeping the number of items in a dropbox below 200, the approximate number most people are comfortable with while waiting for the contents to load, with 400 being an upper limit in extreme cases. There have been issues reported with Second Life object inventories when people go substantially over these numbers.<br />
<br />
=== Moving / Returning DropBox ===<br />
----<br />
If your DropBox is accidentally returned to your inventory, simply rez it back out from your "Lost & Found" folder. No additional action needs to be taken once the DropBox is rezzed out once more; the site will pick up the contents automatically. <br />
<br />
If you need to move, simply follow these steps: <br />
:# Right-click DropBox<br />
:# Select "Take a copy" <br />
:# Click DropBox again<br />
:# Select "Delete" from popup menu<br />
:# Confirm delete (This will flush contents from website cache) <br />
:# Go to new location<br />
:# Rez copy of DropBox <br />
:# All set! <br />
<br />
=== Must Stay Rezzed ===<br />
----<br />
Your dropbox must be rezzed out - inworld - '''AT ALL TIMES''' or it cannot deliver your products, notecards, etc. to your customers.<br />
<br />
'''Remember:''' All Scripted delivery objects will not function if you do not rez them under the proper land group (when it is group land). DropBoxes are no exception. <br />
<br />
=== Placement ===<br />
----<br />
It doesn't matter where you put your DropBox. However, there are certain caveats you should be aware of:<br />
<br />
:# The land must let YOU run scripts - either enabled for all, or you are in the land group.<br />
:# You must have continual access, in order to add/remove products.<br />
<br />
=== Public or Private Land? ===<br />
----<br />
Other people cannot edit your dropboxes (unless you've given them "mod rights" on your stuff), so public locations are perfectly safe.<br />
<br />
However, please read the rental agreement / land covenant FOR that location so make sure dropboxes in general are allowed - because land managers/owners can still return objects, even if they can't do anything else to them. <br />
<br />
=== Renaming Your DropBoxes ===<br />
----<br />
By default, the "physical" name of your dropbox is something like:<br />
<br />
CasperVend DropBox v((version #))<br />
<br />
It's not only ok to rename your DropBox, it is '''strongly recommended''' - at least to include YOUR store name. The name of the DropBox your product comes from is seen in the delivery message that the customer receives - so be aware of that when renaming the box.<br />
<br />
Renaming is also recommended because if someone mutes "CasperVend DropBox v((version #))" from someone else, and YOUR DropBox name matches that, yours will get caught in that muting as well. <br />
<br />
=== Seeing your DropBoxes ===<br />
----<br />
<br />
DropBoxes are now listed on the CasperVend website, on the '''[https://caspervend.casperdns.com/dropboxes.php DropBoxes]''' page. <br />
<br />
This page shows you: <br />
:# Name of the DropBox <br />
:# Version number<br />
:# Sim location (clickable link to location inworld) <br />
:# Last contacted<br />
:# # of items in the DropBox<br />
:# Option to '''manage''' that specific DropBox and see the '''contents" <br />
<br />
At the top of that page you can also list "10, 20, 50, 100 or All" of your DropBoxes at once. The default is 10 per page.<br />
<br />
=== DropBox Address Message ===<br />
----<br />
<br />
The DropBox that responds to a request to deliver an object will send its physical location with the delivery message. <br />
<br />
This is a grid limitation by the Lindens and cannot be changed via scripting. This was instituted several years ago by the Lindens as an anti-griefing measure, to make it easier to report the location of a griefing object, and it applies to ALL objects across the grid that send messages. <br />
<br />
While you don't have to keep your DropBox in your store or rental headquarters, keep in mind that the occasional customer may unexpectedly drop in where the DropBox is located if they click the address link. You can set up a security orb (or banlines) if you wish on a '''private''' location, or just relocate the box(es) to a location where you don't mind customers occasionally dropping in.<br />
<br />
= '''<span style="color:#00528c">Using Your DropBox</span>''' =<br />
''The DropBox only '''seems''' no-modify in your inventory. This is due to the DropBox script being no-modify. Once you rez it out, the prim WILL be modifiable and allow you to add contents.''<br />
<br />
== '''<span style="color:#00528c">Organising Your Items</span>''' ==<br />
How you organize your DropBox contents is ENTIRELY up to you.<br />
<br />
:*It doesn't matter which items are in which box<br />
:*It doesn't matter where your box is in Second Life (caveats: see '''[[#DropBox_placement|Placement]]''').<br />
:* '''[[CasperVend_2/DropBoxes#Setting_Up_Duplicate_DropBoxes | Duplicate sets]]''' are always recommended<br />
<br />
There is one organisational limitation that you must always remember:<br />
<br />
:*Be careful to give '''all items''' a unique name. For example, '''don't''' name a texture the same as one of your items - If you have two different items with the exact same name (in different DropBoxes), the system '''may assume''' it is a second copy of the first item and may deliver ''either one''!<br />
<br />
And yes, capitalisation and typos count!<br />
<br />
== '''<span style="color:#00528c">CasperLet Specific Information</span>''' ==<br />
<br />
The bulk of this page is written with CasperVend and CasperUpdate in mind. <br />
<br />
While the DropBox within the CasperLet crate is the same thing (with the same script) that's in the CasperVend and CasperUpdate crate, CasperLet itself only uses notecards and landmarks. <br />
<br />
If you '''only''' use CasperLet, understand that you will only be loading notecards and landmarks in your DropBox, despite references in most of this page to "products". <br />
<br />
== '''<span style="color:#00528c">Loading Your Dropbox</span>''' ==<br />
<br />
:#Rez the DropBox out<br />
:#Right-click on the DropBox<br />
:#Select "Edit", then go to "Contents" tab. <br />
:#Drag your packaged items, textures and any notecards you have ready into the dropbox.<br />
:#Make sure that your notecards / landmarks / textures / packaged items are all named differently - if you name a texture the same as your object, for example, the vendor system will deliver - or redeliver - '''one''' of '''either''' of them. This means that if your customer pays for a packaged product, and your texture has the exact same name as your packaged product, the customer may get the texture '''instead''' of the packaged product.<br />
<br />
=== Cannot Share DropBoxes ===<br />
----<br />
'''The DropBox only recognizes the owner that unpacked it from the shipping crate.''' <br />
<br />
You cannot "share with group", it will not load other people's products. You cannot deed to a group, because the DropBox is no transfer. (And even if you could, it wouldn't work - the group would then be the owner, and the group isn't the one that purchased the copy of CasperVend that the DropBox came from...)<br />
<br />
=== No Folders ===<br />
----<br />
DropBoxes '''CANNOT''' accept a folder AS a folder - it will always assume the contents of the folders are separate products. If you have multiple items for one product, they need to go in '''THEIR OWN''' box / bag / shipping crate / package before going in the dropbox. Do not put an object named NYAN into the DropBox or strange things may happen...<br />
<br />
=== Your DropBox won't let you add things? ===<br />
----<br />
The grid is known for occasionally not letting things work as well as they should. Here are some troubleshooting points if it doesn't seem like the DropBox is letting you put stuff in it: <br />
<br />
: # Did you "lock" the dropbox (maybe to prevent accidently deleting it)? <br />
: # Has everything in the dropbox fully loaded in the edit / contents window? (SL usually won't let you add things until everything is loaded)<br />
: # Is SL not letting you do other things either? (may need to relog...)<br />
: # Try CTL + dragging the item from your inventory to the DropBox.<br />
: # Is it round or a box? If it's round, you've grabbed the "UpgradeBee DROPBOXES ONLY" by mistake, and that will ALWAYS be no-mod. Search for '''"CasperTech DropBox"''' instead.<br />
<br />
=== "How do I connect the DropBox to...." ===<br />
----<br />
<br />
You don't. All the dropboxes work as inworld "cloud/pool storage" for deliveries - this is why duplicate sets are such a good idea. There's no need to even try to "pin" a dropbox to a specific vendor, the system will automatically pull a product for delivery from the first dropbox that (1) responds, and (2) HAS the item being requested.<br />
<br />
== '''<span style="color:#00528c">Updating Your DropBox</span>''' ==<br />
<br />
=== Updating With New Products ===<br />
----<br />
The SL grid does not allow one object to load inventory into another object in a different sim/region. You must manually add each of your new packaged products to '''EACH''' DropBox you want them to be in. "Cloud/pool" only applies to '''deliveries''' for customer purchases.<br />
<br />
=== Updating DropBox Version ===<br />
----<br />
See '''[[CasperVend_2/DropBoxes#Upgrading_Your_DropBoxes | this section]]'''<br />
<br />
== '''<span style="color:#00528c">Products Not Showing On Site?</span>''' ==<br />
There are '''four''' common principles behind why product packages may not show up on the website to be added to a new listing. They are: <br />
<br />
: 1) DropBox cannot be contacted<br />
: 2) Duplicated name of notecard/texture/etc. <br />
: 3) Product is "(no transfer)" to YOU, the merchant-owner<br />
: 4) Product is not in the dropbox<br />
<br />
There is also one big reason why product packages don't show on the '''PRODUCTS''' page itself, '''OR''' in the list of products to add to a profile: <br />
: 5) Products have not had a '''[[CasperVend_2/Product_Options | product listing]]''' created yet<br />
<br />
=== Can't be contacted ===<br />
----<br />
Common error points when the DropBox(es) can't be contacted are: <br />
# DropBox(es) not rezzed out (Like all scripted inworld delivery systems, they cannot deliver if not rezzed out...) <br />
# DropBox(es) has no script (need "CasperTech Dropbox" script to stay in the box) <br />
# The sim the DropBox(es) is(are) on is having a snit and not talking to the outside world (the "gone dark" issue mentioned in the backup section below) <br />
<br />
=== Duplicated Names ===<br />
----<br />
Common error is that the product name exactly matches the name of a texture or notecard. <br />
<br />
The popup for product selection is set to filter out duplicates - so this results in new products not showing because the texture or notecard is showing instead. <br />
<br />
# Rename your product package, corresponding notecard, and corresponding texture so that the names are '''ALL''' different from each other.<br />
<br />
=== Product is "no transfer" ===<br />
----<br />
Products MAY end up being effectively "(no transfer)" to you for different reasons: <br />
# Putting a holo demo in the DropBox instead of the holovendor<br />
# An errant script, texture, or other "(no transfer)" item included with the product by accident. (Might be accidentally linked to a build, or accidentally dropped in the contents of a prim.)<br />
<br />
Verify that all your items are transferable TO YOU by looking in the contents of (each) DropBox, waiting for the contents to load, and scrolling the list to the right to see the permissions. Scroll down to see everything in the DropBox and verify whether or not "(no transfer)" is next to any of the items.<br />
<br />
=== Not in the dropbox ===<br />
----<br />
# Did you forget to put it in the dropbox? <br />
# Did you perhaps put the product in the vendor instead of the DropBox?<br />
# When you rezzed (or re-rezzed) the DropBox, did you rez an older version that's missing the new item(s)?<br />
<br />
== '''<span style="color:#00528c">Products Not Showing On Products Page? </span>''' ==<br />
<br />
You won't see '''anything''' on the product page until a listing has been created for the product(s) in question. <br />
<br />
CasperVend does not show product '''packages''' on the '''[https://caspervend.casperdns.com/productsNew.php Products page]''', only completed product '''listings'''. <br />
<br />
You must create your product listings - if all goes well (see previous section for common troubleshooting points) then you'll see your missing packages in the popup for selecting a package to deliver, once you start creating your product listing. <br />
<br />
Start at #9 '''[[CasperVend_2/Quick_Start | on this page]]''' to create your product listings.<br />
<br />
=== Product Selector Popup Not Appearing On Website? ===<br />
----<br />
You may have a browser extension that's blocking the popup product picker window. <br />
<br />
If you are using Chrome, you can start another Chrome window in 'Incognito" mode - use CTL + SHFT + N to start an Incognito window. This disables all the extensions before logging you in. <br />
<br />
If you are using Firefox (or another browser) with a a "no javascript" type extension that allows a temporary override, you need to allow '''casperdns.com''' and '''ajax.googleapis.com''' to be able to see the product picker popup window.<br />
<br />
= '''<span style="color:#00528c">Upgrading Your DropBoxes</span>''' =<br />
:# Verify version: Click the DropBox, and from the popup menu, select "Version".<br />
:# Compare with the list on the '''[[Current_Versions | versions page]]'''.<br />
:# If your DropBox is out of date, '''redeliver''' the pack that your dropbox came from. (Old Bee only has old version.)<br />
:# Once you have a redelivered shipping crate, unpack that.<br />
:# Pull out the '''NEW''' UpgradeBee DROPBOXES ONLY.<br />
:# Rez one in each sim/region you have DropBox(es), and select '''RUN UPDATE'''. <br />
:# The UpgradeBee will fly around and update all of your DropBox(es).<br />
<br />
If you get an error message for "Illegal Task" '''or''' "0 attempted / 0 upgraded / 0 no longer exist / 0 weren't upgraded because..." message, then click the dropbox, and from the popup menu, select "Reset". <br />
<br />
=== "I Don't Have That Many Vendors Out!" ===<br />
----<br />
When you use the "check all" function, it will check '''everyone's''' vendors AND dropboxes on the sim. <br />
<br />
This is normal! <br />
<br />
It cannot actually upgrade anything that's not YOURS - but it will ping CasperVend things from everyone on the sim and see if the items are still rezzed out. <br />
<br />
=== Verifying the update worked ===<br />
----<br />
:* Click the DropBox. <br />
:* Select "Version" from the popup.<br />
:* (If you don't have "version" as an option, they need to be upgraded...) <br />
:* The DropBox will tell you its version in local chat. <br />
<br />
The DropBox '''prim''' will not be renamed by the UpgradeBee - this is normal. If you want the object name to reflect the version, you must rename it manually.<br />
<br />
= '''<span style="color:#00528c">Delivery Errors</span>''' =<br />
<br />
See the '''[[CasperVend_2/Deliveries#Delivery_Errors | delivery errors section]]''' on the transactions page.<br />
<br />
= '''<span style="color:#00528c">E-Mail Self Test Yellow Text Message</span>''' =<br />
:: '''''WARNING: This dropbox failed its e-mail self-test. This means that the box may become uncontactable, which may affect your deliveries. Please pick up this box and re-rez it.'''''<br />
<br />
This is a test feature new with version 2.27 - it's designed to let you know when the sim has blacklisted the dropbox in question. <br />
<br />
Make sure your DropBox is on the '''[[Current_Versions | latest version.]]''' If it's not, then follow '''[[CasperVend_2/DropBoxes#Updating_DropBox_Version | these instructions]]''' to get it up to date.<br />
<br />
This message '''has been removed in current versions.''' If you see any variant of this message, it means your DropBox is '''NOT''' up to date!<br />
<br />
= '''<span style="color:#00528c">Cleanly Deleting Old DropBoxes</span>''' =<br />
'''Properly''' deleting an older (or unused) DropBox is '''essential''' for a cleaner database - following these steps means that the DropBox will flush its contents out of the database before deleting itself. <br />
<br />
'''Remember to "take a copy" FIRST!'''<br />
<br />
# Click the DropBox<br />
# Select "Delete" from the popup menu<br />
# The DropBox will give you a confirmation screen; if you really want to delete it, click the appropriate option<br />
# The DropBox will clear its contents out of the website, before deleting itself inworld<br />
<br />
=== Products Showing That No Longer Exist? ===<br />
----<br />
This issue is most often caused by simply using "Edit > Delete" on an existing DropBox, '''OR''' a DropBox is accidentally returned to your lost & found folder. <br />
<br />
Here's the way to fix this: <br />
<br />
:# Log in to the CasperVend website<br />
:# Go to the '''[https://caspervend.casperdns.com/dropboxes.php DropBoxes page]'''<br />
:# You will see a list of all the DropBoxes the system thinks are still rezzed inworld. <br />
:# Click the '''"contents"''' link next to each dropbox and look through the contents<br />
:# When you find the incorrect dropbox, click '''"Manage"''' on the same line<br />
:# You will be taken to another page<br />
:# To delete that dropbox, select '''"Delete Unit"'''<br />
:# You will get a confirmation popup - click "ok"<br />
:# The system will process, and then reload the main DropBoxes page<br />
<br />
=== Accidentally Returned/Picked Up ===<br />
----<br />
Simply re-rez the DropBox. Your vendors will resume normal delivery operations without needing to touch anything on the website.<br />
<br />
= '''<span style="color:#00528c">The "DropBox Cloud"</span>''' =<br />
<br />
All DropBox(es) you have rezzed anywhere on the grid contribute to the "global product cloud" of your products. This is why it doesn't matter where you're dropboxes are, as long as they are rezzed inworld. <br />
<br />
The website will deliver '''one''' copy of the configured item, from '''the first available''' DropBox that has that product, AND responds in a timely manner. Due to general grid crappiness, sometimes a sim/region doesn't respond as well as it should - and having duplicates on different sims/regions means that the website has the opportunity to use other dropboxes for the delivery of that item instead of completely failing. <br />
<br />
So yes, multiple / duplicate / backup DropBox(es) are not only totally ok, they are actually encouraged!<br />
<br />
== '''<span style="color:#00528c">Setting Up Duplicate DropBoxes</span>''' ==<br />
You may think "backup sets", but it's really "duplicate sets" - the system does not seek out one set as a primary, the dropboxes send the product from (1) the first one to respond to the deliver command, that (2) has the product. If that's on your home sim, then that's where it comes from. If the first one to respond is one of your duplicated locations, then that's where it gets sent from. <br />
<br />
If you like, and you have multiple locations for your DropBoxes, you can work with ONE set as a "master set" of DropBoxes. Then, when you are done adding things in a particular session, simply do the following steps: <br />
<br />
# Right-click, then "Take a copy" of your existing DropBox(es)<br />
# Go to another sim/region where you have long-term rez rights. (If you're Premium and have a free parcel allowance, this would also be an ideal location. Please note that dropboxes are not allowed on Linden Homes, and please always check the covenant of the land you're using.) <br />
# Rez out the DropBox(es)<br />
# Wait for the DropBox(es) to talk to the website. <br />
# All set! Remember to leave the DropBox(es) rezzed at all times. <br />
<br />
You may organize your DropBoxes however you'd like, and you can rez however many you'd like (up to the maxmium prim/impact limits of the parcel, of course). <br />
<br />
=== Updating Duplicate DropBox(es) ===<br />
----<br />
If you want the products in all of your DropBox(es) to stay updated compared to each other, you will, unfortunately, need to do that manually. <br />
<br />
You can "designate" one set of DropBox(es) as your "master set" - this is NOT a scripted setting, and NOT something you do on the website, but in this case simply refers to the set that you update FIRST - whether you have it on your build platform (and set up an orb to keep random people from dropping in) or hanging out in your store is up to you. <br />
<br />
There are two ways of doing this: <br />
<br />
==== Adding Individual New Products ====<br />
----<br />
<br />
:# Go to each DropBox location<br />
:# Add the new product(s) to each pertinent DropBox<br />
<br />
If replacing old products, rather than just adding new: <br />
<br />
:# Go to each DropBox location<br />
:# Delete the old copy of the product you are replacing<br />
:# Replace with the new product<br />
<br />
Go around to all dropbox locations and add the new products to the pertinent DropBox(es) via Right-Click > Edit > Contents tab<br />
<br />
==== Replacing Older DropBox(es) ====<br />
---- <br />
<br />
:# Right-click > "Take a copy" of each dropbox that has been updated with new or replacement products <br />
:# Go to each additional DropBox location<br />
:# Delete the old copy rezzed out <br />
:# Replace with the new copy you just picked up <br />
:# Rez an upgradebee <br />
:# Wait for it to boot<br />
:# Click > select "Check All" <br />
:# Wait for it to run<br />
:# When it completes, simply delete the Bee<br />
<br />
You may see more numbers of objects it is checking than what you have/had rezzed out - this is normal, as a "check" will check ANYONE's, not just yours. It '''cannot''' do anything to anyone else's objects (and thus nobody else's upgrade bee can do anything to yours) - it just "pings" every CasperVend vendor or DropBox it knows WAS rezzed on the sim to see if it's still there.<br />
<br />
==== Last One Updated, First One Contacted ====<br />
----<br />
<br />
Usually, the last DropBox that gets updated with a new product is the one that the system tries to contact first.<br />
<br />
=== NOT On The Same Region ===<br />
----<br />
Having boxes containing the same item, on the '''same region''' is generally pointless. The goal behind having duplicate locations is to have reliability in case of sim/region-to-outside-world communication issues. Having all duplicate sets on the same sim/region means that they will all be affected when the sim/region goes out to lunch or runs out of URL's.<br />
<br />
=== On Different Regions ===<br />
----<br />
Having one or more duplicate DropBox(es) (DropBoxes containing the same items) on another region is '''HIGHLY recommended'''.<br />
<br />
Partly this is so that you have DropBoxes that work even when the simulator/region is down (especially if you have affiliate vendors out on the grid, or multiple locations) but also because simulators/regions occasionally "go dark" and refuse to talk to the outside world. The sim/region will still be up, inworld, and accessible to avatars even in this state, but because it's not talking to the outside world, DropBoxes on these affected sims/regions will be unable to deliver product to customers.<br />
<br />
Having one or more duplicate sets on other sims/regions reduces the chance that YOUR products won't deliver, when customers make a purchase or redeliver (thus making customers think you are no longer active as a merchant). These backup locations can be friend's homes, etc. <br />
<br />
There are also [https://wiki.casperdns.com/index.php/DropBox_Hosting DropBox Hosting services on the grid] that will allow you to rent a few prims just for DropBox purposes.<br />
<br />
= '''<span style="color:#00528c">DropBox Page on Website</span>''' =<br />
Your DropBoxes are now listed on the website, on the [https://wiki.casperdns.com/index.php/CasperVend_2/DropBoxes DropBoxes page]!<br />
<br />
The list is "colour coded" according to how long it's been since the site last contacted the dropbox. It does '''NOT''' mean that it's broken - deliveries will still happen. If you're concerned that it's shown with a colour background other than white, you may click the dropbox inworld and select "reset" - that'll make it contact the website and turn it white. It is '''NOT''' required that you do that - not being contacted doesn't mean it's not working. <br />
<br />
== The Columns ==<br />
:'''Last Seen:''' This is how long it's been since the website last talked to the dropbox. <br />
:'''Version:''' This is the script-reported version of the dropbox. An easy way to tell when you need to [[Current_Versions | check your versions]]. <br />
:'''Location:''' This is the listing of the sim, with a SLURL to the exact location where the DropBox is inworld. <br />
:'''Actions:''' You can "Manage" or view the "Contents" of the dropbox from this column. "Manage" gives you a page where you can ping, update, or delete the dropbox. "Contents" just shows you what's in it.<br />
<br />
== Colour Coding ==<br />
Yellow is for not being contacted for a short time. Pink is for not being contacted for a longer time. <br />
<br />
The variations in yellow and pink do not represent any specific timeframe, they alternate lighter and darker to make it easier for your eyes to follow a specific line.<br />
<br />
= '''<span style="color:#00528c">FAQ / Troubleshooting</span>''' =<br />
<br />
: '''Q. Why'd my vendors suddenly stop delivering notecards / demos / products?'''<br />
:: '''A.''' Things cannot be delivered if the system cannot find the dropbox, and/or cannot find the product items it's been told to send. Therefore, the first points to check are: <br />
::: * Is the item IN the dropbox? <br />
::: * Is the site pointing to the correct item(s)<br />
::: * Have you recently change name on the product / notecard / demo, without updating the website? <br />
::: * Has the sim/region "gone dark"? (If so, the only solution is restart the sim and/or have backup copies on at least one other sim/region.) <br />
::: * How many items are in your dropbox? (Remember if there are too many things in the dropbox, the SL servers seem to make stuff "go missing" - which would also prevent delivery of items.) <br />
::: * Also compare YOUR transaction log with the information in the '''[[CasperVend_2/Deliveries | Transactions & Deliveries]]''' page.<br />
<br />
: '''Q. My customers aren't getting the product after purchase, and the redelivery terminal keeps giving them a "Failed: Couldn't find delivery box for item on SLIFE. This merchant may no longer be using CasperVend." message, when it is, and I am.'''<br />
:: '''A1.''' Reset the DropBox(es). Use the touch menu first - if that doesn't work, then manually Edit > Reset scripts in selection to get them to actually reset. <br />
:: '''A2.''' If you have DropBox(es) on only one sim/region, then we strongly recommend having a backup set (see above) on at least one other sim/region location to reduce the risk of this happening again. <br />
<br />
: '''Q. I have a DropBox which shows as 'live' and as having __ items listed. However, when I open the drop box there are maybe half that amount of items showing inside the box.'''<br />
:: '''A.''' Casper Warden writes: "basically, if items have disappeared from the box, there's two possible reasons...<br />
::: '''1)''' they were no copy and were delivered<br />
::: '''2)''' your sim suffered an inventory failure or rollback<br />
:: in both circumstances the system isn't notified about the change :/ " <br />
:: When items that are no-copy to the merchant (such as breedable things) get sold, the # in the floaty text above the dropbox does NOT get updated.<br />
<br />
:'''Q. I got this message: "CasperVend DropBox: Items in the database seem to be out of sync! Re-uploading."'''<br />
:: '''A.''' Nothing to worry about - the system's self-check has determined that there is lag, either on the sim/region or in the grid itself. Once or twice per DropBox is normal (if you have multiple DropBoxes, you'll get several messages, but should just be one or two from each.) <br />
:: The only time to worry is when you get the message several times a day - that would indicate a sim/region communication problem, or that Casper is working on the backend servers. <br />
<br />
:'''Q. My last shop location is no more, I don't have access to it, and it keeps trying to send the OLD landmark. How can I fix this? '''<br />
:: '''A1.''' You'll need to edit *everywhere* you have it marked - usually this is in each and every single product listing - and set them up with the new landmark. <br />
:: '''A2.''' It is STRONGLY RECOMMENDED that you use a landmark name like '''"(your shop) - Main location"''' - rather than the default LL format that includes the sim/region name. Renaming your landmarks to something simple and WITHOUT the sim/region name means that when you have to move in the future, you can just outright swap the landmarks, without having to go through the hassle of updating every single product every time you change landmarks. <br />
<br />
:'''Q. I keep getting messages of "That item is no longer available or doesn't belong to you." when it is, and it does. '''<br />
:: '''A.''' Pick up and re-rez the DropBox, that should get rid of the spurious errors.</div>24607dde-d704-4db7-afa0-d9edc17c926chttps://wiki.casperdns.com/index.php?title=CasperVend_2/DropBoxes&diff=15328CasperVend 2/DropBoxes2023-08-31T18:14:08Z<p>24607dde-d704-4db7-afa0-d9edc17c926c: /* On Different Regions */</p>
<hr />
<div>{|align=right<br />
|__TOC__<br />
|}<br />
<br />
<!---- Keywords: product server ----> <br />
<br />
[[File:German_flag.gif]] [[CasperVend 2/DropBoxes/DE | Schaue hier in Deutsch!]]<br />
<br />
= '''<span style="color:#00528c">About the DropBox</span>''' =<br />
<br />
=== Current Version ===<br />
----<br />
Current version information may be '''[[Current_Versions | seen here]]'''. It's always a good idea to keep your dropbox(es) up to date, since version changes are quite often working around new bugs in sim communications that can cause failed deliveries.<br />
<br />
=== Debit Permissions - Version 2.70 and up ===<br />
----<br />
* '''Dropboxes now ask for debit permissions''' and may now be used to make payments for vendor refunds.<br />
* When an outgoing payment is made, the transaction URL will now appear in your Second Life transaction history instead of the object name, to help with tracking and avoid confusion when different objects are used for payments (See '''[https://wiki.casperdns.com/images/e/e9/CV_transaction_URL.png this image]''' for example.)<br />
* The "URL" warning should no longer occur on region restart ('''unless''' legitimate)<br />
<br />
See '''[https://wiki.casperdns.com/index.php/CasperVend_2/Vendors/ChangeLog#Dropboxes_and_debit_permissions Vendor Changelog]''' and '''[https://wiki.casperdns.com/index.php/Debit_Permissions Debit Permissions]''' pages for details.<br />
<br />
'''You will need to remain ON THE SIM/REGION while you are updating to v2.70, because of the need to answer the debit permissions windows!'''<br />
<br />
=== Limits ===<br />
----<br />
We recommend keeping the number of items in a dropbox below 200, the approximate number most people are comfortable with while waiting for the contents to load, with 400 being an upper limit in extreme cases. There have been issues reported with Second Life object inventories when people go substantially over these numbers.<br />
<br />
=== Moving / Returning DropBox ===<br />
----<br />
If your DropBox is accidentally returned to your inventory, simply rez it back out from your "Lost & Found" folder. No additional action needs to be taken once the DropBox is rezzed out once more; the site will pick up the contents automatically. <br />
<br />
If you need to move, simply follow these steps: <br />
:# Right-click DropBox<br />
:# Select "Take a copy" <br />
:# Click DropBox again<br />
:# Select "Delete" from popup menu<br />
:# Confirm delete (This will flush contents from website cache) <br />
:# Go to new location<br />
:# Rez copy of DropBox <br />
:# All set! <br />
<br />
=== Must Stay Rezzed ===<br />
----<br />
Your dropbox must be rezzed out - inworld - '''AT ALL TIMES''' or it cannot deliver your products, notecards, etc. to your customers.<br />
<br />
'''Remember:''' All Scripted delivery objects will not function if you do not rez them under the proper land group (when it is group land). DropBoxes are no exception. <br />
<br />
=== Placement ===<br />
----<br />
It doesn't matter where you put your DropBox. However, there are certain caveats you should be aware of:<br />
<br />
:# The land must let YOU run scripts - either enabled for all, or you are in the land group.<br />
:# You must have continual access, in order to add/remove products.<br />
<br />
=== Public or Private Land? ===<br />
----<br />
Other people cannot edit your dropboxes (unless you've given them "mod rights" on your stuff), so public locations are perfectly safe.<br />
<br />
However, please read the rental agreement / land covenant FOR that location so make sure dropboxes in general are allowed - because land managers/owners can still return objects, even if they can't do anything else to them. <br />
<br />
=== Renaming Your DropBoxes ===<br />
----<br />
By default, the "physical" name of your dropbox is something like:<br />
<br />
CasperVend DropBox v((version #))<br />
<br />
It's not only ok to rename your DropBox, it is '''strongly recommended''' - at least to include YOUR store name. The name of the DropBox your product comes from is seen in the delivery message that the customer receives - so be aware of that when renaming the box.<br />
<br />
Renaming is also recommended because if someone mutes "CasperVend DropBox v((version #))" from someone else, and YOUR DropBox name matches that, yours will get caught in that muting as well. <br />
<br />
=== Seeing your DropBoxes ===<br />
----<br />
<br />
DropBoxes are now listed on the CasperVend website, on the '''[https://caspervend.casperdns.com/dropboxes.php DropBoxes]''' page. <br />
<br />
This page shows you: <br />
:# Name of the DropBox <br />
:# Version number<br />
:# Sim location (clickable link to location inworld) <br />
:# Last contacted<br />
:# # of items in the DropBox<br />
:# Option to '''manage''' that specific DropBox and see the '''contents" <br />
<br />
At the top of that page you can also list "10, 20, 50, 100 or All" of your DropBoxes at once. The default is 10 per page.<br />
<br />
=== DropBox Address Message ===<br />
----<br />
<br />
The DropBox that responds to a request to deliver an object will send its physical location with the delivery message. <br />
<br />
This is a grid limitation by the Lindens and cannot be changed via scripting. This was instituted several years ago by the Lindens as an anti-griefing measure, to make it easier to report the location of a griefing object, and it applies to ALL objects across the grid that send messages. <br />
<br />
While you don't have to keep your DropBox in your store or rental headquarters, keep in mind that the occasional customer may unexpectedly drop in where the DropBox is located if they click the address link. You can set up a security orb (or banlines) if you wish on a '''private''' location, or just relocate the box(es) to a location where you don't mind customers occasionally dropping in.<br />
<br />
= '''<span style="color:#00528c">Using Your DropBox</span>''' =<br />
''The DropBox only '''seems''' no-modify in your inventory. This is due to the DropBox script being no-modify. Once you rez it out, the prim WILL be modifiable and allow you to add contents.''<br />
<br />
== '''<span style="color:#00528c">Organising Your Items</span>''' ==<br />
How you organize your DropBox contents is ENTIRELY up to you.<br />
<br />
:*It doesn't matter which items are in which box<br />
:*It doesn't matter where your box is in Second Life (caveats: see '''[[#DropBox_placement|Placement]]''').<br />
:* '''[[CasperVend_2/DropBoxes#Setting_Up_Duplicate_DropBoxes | Duplicate sets]]''' are always recommended<br />
<br />
There is one organisational limitation that you must always remember:<br />
<br />
:*Be careful to give '''all items''' a unique name. For example, '''don't''' name a texture the same as one of your items - If you have two different items with the exact same name (in different DropBoxes), the system '''may assume''' it is a second copy of the first item and may deliver ''either one''!<br />
<br />
And yes, capitalisation and typos count!<br />
<br />
== '''<span style="color:#00528c">CasperLet Specific Information</span>''' ==<br />
<br />
The bulk of this page is written with CasperVend and CasperUpdate in mind. <br />
<br />
While the DropBox within the CasperLet crate is the same thing (with the same script) that's in the CasperVend and CasperUpdate crate, CasperLet itself only uses notecards and landmarks. <br />
<br />
If you '''only''' use CasperLet, understand that you will only be loading notecards and landmarks in your DropBox, despite references in most of this page to "products". <br />
<br />
== '''<span style="color:#00528c">Loading Your Dropbox</span>''' ==<br />
<br />
:#Rez the DropBox out<br />
:#Right-click on the DropBox<br />
:#Select "Edit", then go to "Contents" tab. <br />
:#Drag your packaged items, textures and any notecards you have ready into the dropbox.<br />
:#Make sure that your notecards / landmarks / textures / packaged items are all named differently - if you name a texture the same as your object, for example, the vendor system will deliver - or redeliver - '''one''' of '''either''' of them. This means that if your customer pays for a packaged product, and your texture has the exact same name as your packaged product, the customer may get the texture '''instead''' of the packaged product.<br />
<br />
=== Cannot Share DropBoxes ===<br />
----<br />
'''The DropBox only recognizes the owner that unpacked it from the shipping crate.''' <br />
<br />
You cannot "share with group", it will not load other people's products. You cannot deed to a group, because the DropBox is no transfer. (And even if you could, it wouldn't work - the group would then be the owner, and the group isn't the one that purchased the copy of CasperVend that the DropBox came from...)<br />
<br />
=== No Folders ===<br />
----<br />
DropBoxes '''CANNOT''' accept a folder AS a folder - it will always assume the contents of the folders are separate products. If you have multiple items for one product, they need to go in '''THEIR OWN''' box / bag / shipping crate / package before going in the dropbox. Do not put an object named NYAN into the DropBox or strange things may happen...<br />
<br />
=== Your DropBox won't let you add things? ===<br />
----<br />
The grid is known for occasionally not letting things work as well as they should. Here are some troubleshooting points if it doesn't seem like the DropBox is letting you put stuff in it: <br />
<br />
: # Did you "lock" the dropbox (maybe to prevent accidently deleting it)? <br />
: # Has everything in the dropbox fully loaded in the edit / contents window? (SL usually won't let you add things until everything is loaded)<br />
: # Is SL not letting you do other things either? (may need to relog...)<br />
: # Try CTL + dragging the item from your inventory to the DropBox.<br />
: # Is it round or a box? If it's round, you've grabbed the "UpgradeBee DROPBOXES ONLY" by mistake, and that will ALWAYS be no-mod. Search for '''"CasperTech DropBox"''' instead.<br />
<br />
=== "How do I connect the DropBox to...." ===<br />
----<br />
<br />
You don't. All the dropboxes work as inworld "cloud/pool storage" for deliveries - this is why duplicate sets are such a good idea. There's no need to even try to "pin" a dropbox to a specific vendor, the system will automatically pull a product for delivery from the first dropbox that (1) responds, and (2) HAS the item being requested.<br />
<br />
== '''<span style="color:#00528c">Updating Your DropBox</span>''' ==<br />
<br />
=== Updating With New Products ===<br />
----<br />
The SL grid does not allow one object to load inventory into another object in a different sim/region. You must manually add each of your new packaged products to '''EACH''' DropBox you want them to be in. "Cloud/pool" only applies to '''deliveries''' for customer purchases.<br />
<br />
=== Updating DropBox Version ===<br />
----<br />
See '''[[CasperVend_2/DropBoxes#Upgrading_Your_DropBoxes | this section]]'''<br />
<br />
== '''<span style="color:#00528c">Products Not Showing On Site?</span>''' ==<br />
There are '''four''' common principles behind why product packages may not show up on the website to be added to a new listing. They are: <br />
<br />
: 1) DropBox cannot be contacted<br />
: 2) Duplicated name of notecard/texture/etc. <br />
: 3) Product is "(no transfer)" to YOU, the merchant-owner<br />
: 4) Product is not in the dropbox<br />
<br />
There is also one big reason why product packages don't show on the '''PRODUCTS''' page itself, '''OR''' in the list of products to add to a profile: <br />
: 5) Products have not had a '''[[CasperVend_2/Product_Options | product listing]]''' created yet<br />
<br />
=== Can't be contacted ===<br />
----<br />
Common error points when the DropBox(es) can't be contacted are: <br />
# DropBox(es) not rezzed out (Like all scripted inworld delivery systems, they cannot deliver if not rezzed out...) <br />
# DropBox(es) has no script (need "CasperTech Dropbox" script to stay in the box) <br />
# The sim the DropBox(es) is(are) on is having a snit and not talking to the outside world (the "gone dark" issue mentioned in the backup section below) <br />
<br />
=== Duplicated Names ===<br />
----<br />
Common error is that the product name exactly matches the name of a texture or notecard. <br />
<br />
The popup for product selection is set to filter out duplicates - so this results in new products not showing because the texture or notecard is showing instead. <br />
<br />
# Rename your product package, corresponding notecard, and corresponding texture so that the names are '''ALL''' different from each other.<br />
<br />
=== Product is "no transfer" ===<br />
----<br />
Products MAY end up being effectively "(no transfer)" to you for different reasons: <br />
# Putting a holo demo in the DropBox instead of the holovendor<br />
# An errant script, texture, or other "(no transfer)" item included with the product by accident. (Might be accidentally linked to a build, or accidentally dropped in the contents of a prim.)<br />
<br />
Verify that all your items are transferable TO YOU by looking in the contents of (each) DropBox, waiting for the contents to load, and scrolling the list to the right to see the permissions. Scroll down to see everything in the DropBox and verify whether or not "(no transfer)" is next to any of the items.<br />
<br />
=== Not in the dropbox ===<br />
----<br />
# Did you forget to put it in the dropbox? <br />
# Did you perhaps put the product in the vendor instead of the DropBox?<br />
# When you rezzed (or re-rezzed) the DropBox, did you rez an older version that's missing the new item(s)?<br />
<br />
== '''<span style="color:#00528c">Products Not Showing On Products Page? </span>''' ==<br />
<br />
You won't see '''anything''' on the product page until a listing has been created for the product(s) in question. <br />
<br />
CasperVend does not show product '''packages''' on the '''[https://caspervend.casperdns.com/productsNew.php Products page]''', only completed product '''listings'''. <br />
<br />
You must create your product listings - if all goes well (see previous section for common troubleshooting points) then you'll see your missing packages in the popup for selecting a package to deliver, once you start creating your product listing. <br />
<br />
Start at #9 '''[[CasperVend_2/Quick_Start | on this page]]''' to create your product listings.<br />
<br />
=== Product Selector Popup Not Appearing On Website? ===<br />
----<br />
You may have a browser extension that's blocking the popup product picker window. <br />
<br />
If you are using Chrome, you can start another Chrome window in 'Incognito" mode - use CTL + SHFT + N to start an Incognito window. This disables all the extensions before logging you in. <br />
<br />
If you are using Firefox (or another browser) with a a "no javascript" type extension that allows a temporary override, you need to allow '''casperdns.com''' and '''ajax.googleapis.com''' to be able to see the product picker popup window.<br />
<br />
= '''<span style="color:#00528c">Upgrading Your DropBoxes</span>''' =<br />
:# Verify version: Click the DropBox, and from the popup menu, select "Version".<br />
:# Compare with the list on the '''[[Current_Versions | versions page]]'''.<br />
:# If your DropBox is out of date, '''redeliver''' the pack that your dropbox came from. (Old Bee only has old version.)<br />
:# Once you have a redelivered shipping crate, unpack that.<br />
:# Pull out the '''NEW''' UpgradeBee DROPBOXES ONLY.<br />
:# Rez one in each sim/region you have DropBox(es), and select '''RUN UPDATE'''. <br />
:# The UpgradeBee will fly around and update all of your DropBox(es).<br />
<br />
If you get an error message for "Illegal Task" '''or''' "0 attempted / 0 upgraded / 0 no longer exist / 0 weren't upgraded because..." message, then click the dropbox, and from the popup menu, select "Reset". <br />
<br />
=== "I Don't Have That Many Vendors Out!" ===<br />
----<br />
When you use the "check all" function, it will check '''everyone's''' vendors AND dropboxes on the sim. <br />
<br />
This is normal! <br />
<br />
It cannot actually upgrade anything that's not YOURS - but it will ping CasperVend things from everyone on the sim and see if the items are still rezzed out. <br />
<br />
=== Verifying the update worked ===<br />
----<br />
:* Click the DropBox. <br />
:* Select "Version" from the popup.<br />
:* (If you don't have "version" as an option, they need to be upgraded...) <br />
:* The DropBox will tell you its version in local chat. <br />
<br />
The DropBox '''prim''' will not be renamed by the UpgradeBee - this is normal. If you want the object name to reflect the version, you must rename it manually.<br />
<br />
= '''<span style="color:#00528c">Delivery Errors</span>''' =<br />
<br />
See the '''[[CasperVend_2/Deliveries#Delivery_Errors | delivery errors section]]''' on the transactions page.<br />
<br />
= '''<span style="color:#00528c">E-Mail Self Test Yellow Text Message</span>''' =<br />
:: '''''WARNING: This dropbox failed its e-mail self-test. This means that the box may become uncontactable, which may affect your deliveries. Please pick up this box and re-rez it.'''''<br />
<br />
This is a test feature new with version 2.27 - it's designed to let you know when the sim has blacklisted the dropbox in question. <br />
<br />
Make sure your DropBox is on the '''[[Current_Versions | latest version.]]''' If it's not, then follow '''[[CasperVend_2/DropBoxes#Updating_DropBox_Version | these instructions]]''' to get it up to date.<br />
<br />
This message '''has been removed in current versions.''' If you see any variant of this message, it means your DropBox is '''NOT''' up to date!<br />
<br />
= '''<span style="color:#00528c">Cleanly Deleting Old DropBoxes</span>''' =<br />
'''Properly''' deleting an older (or unused) DropBox is '''essential''' for a cleaner database - following these steps means that the DropBox will flush its contents out of the database before deleting itself. <br />
<br />
'''Remember to "take a copy" FIRST!'''<br />
<br />
# Click the DropBox<br />
# Select "Delete" from the popup menu<br />
# The DropBox will give you a confirmation screen; if you really want to delete it, click the appropriate option<br />
# The DropBox will clear its contents out of the website, before deleting itself inworld<br />
<br />
=== Products Showing That No Longer Exist? ===<br />
----<br />
This issue is most often caused by simply using "Edit > Delete" on an existing DropBox, '''OR''' a DropBox is accidentally returned to your lost & found folder. <br />
<br />
Here's the way to fix this: <br />
<br />
:# Log in to the CasperVend website<br />
:# Go to the '''[https://caspervend.casperdns.com/dropboxes.php DropBoxes page]'''<br />
:# You will see a list of all the DropBoxes the system thinks are still rezzed inworld. <br />
:# Click the '''"contents"''' link next to each dropbox and look through the contents<br />
:# When you find the incorrect dropbox, click '''"Manage"''' on the same line<br />
:# You will be taken to another page<br />
:# To delete that dropbox, select '''"Delete Unit"'''<br />
:# You will get a confirmation popup - click "ok"<br />
:# The system will process, and then reload the main DropBoxes page<br />
<br />
=== Accidentally Returned/Picked Up ===<br />
----<br />
Simply re-rez the DropBox. Your vendors will resume normal delivery operations without needing to touch anything on the website.<br />
<br />
= '''<span style="color:#00528c">The "DropBox Cloud"</span>''' =<br />
<br />
All DropBox(es) you have rezzed anywhere on the grid contribute to the "global product cloud" of your products. This is why it doesn't matter where you're dropboxes are, as long as they are rezzed inworld. <br />
<br />
The website will deliver '''one''' copy of the configured item, from '''the first available''' DropBox that has that product, AND responds in a timely manner. Due to general grid crappiness, sometimes a sim/region doesn't respond as well as it should - and having duplicates on different sims/regions means that the website has the opportunity to use other dropboxes for the delivery of that item instead of completely failing. <br />
<br />
So yes, multiple / duplicate / backup DropBox(es) are not only totally ok, they are actually encouraged!<br />
<br />
== '''<span style="color:#00528c">Setting Up Duplicate DropBoxes</span>''' ==<br />
You may think "backup sets", but it's really "duplicate sets" - the system does not seek out one set as a primary, the dropboxes send the product from (1) the first one to respond to the deliver command, that (2) has the product. If that's on your home sim, then that's where it comes from. If the first one to respond is one of your duplicated locations, then that's where it gets sent from. <br />
<br />
If you like, and you have multiple locations for your DropBoxes, you can work with ONE set as a "master set" of DropBoxes. Then, when you are done adding things in a particular session, simply do the following steps: <br />
<br />
# Right-click, then "Take a copy" of your existing DropBox(es)<br />
# Go to another sim/region where you have long-term rez rights. (If you're Premium and have a free parcel allowance, this would also be an ideal location. Please note that dropboxes are not allowed on Linden Homes, and please always check the covenant of the land you're using.) <br />
# Rez out the DropBox(es)<br />
# Wait for the DropBox(es) to talk to the website. <br />
# All set! Remember to leave the DropBox(es) rezzed at all times. <br />
<br />
You may organize your DropBoxes however you'd like, and you can rez however many you'd like (up to the maxmium prim/impact limits of the parcel, of course). <br />
<br />
=== Updating Duplicate DropBox(es) ===<br />
----<br />
If you want the products in all of your DropBox(es) to stay updated compared to each other, you will, unfortunately, need to do that manually. <br />
<br />
You can "designate" one set of DropBox(es) as your "master set" - this is NOT a scripted setting, and NOT something you do on the website, but in this case simply refers to the set that you update FIRST - whether you have it on your build platform (and set up an orb to keep random people from dropping in) or hanging out in your store is up to you. <br />
<br />
There are two ways of doing this: <br />
<br />
==== Adding Individual New Products ====<br />
----<br />
<br />
:# Go to each DropBox location<br />
:# Add the new product(s) to each pertinent DropBox<br />
<br />
If replacing old products, rather than just adding new: <br />
<br />
:# Go to each DropBox location<br />
:# Delete the old copy of the product you are replacing<br />
:# Replace with the new product<br />
<br />
Go around to all dropbox locations and add the new products to the pertinent DropBox(es) via Right-Click > Edit > Contents tab<br />
<br />
==== Replacing Older DropBox(es) ====<br />
---- <br />
<br />
:# Right-click > "Take a copy" of each dropbox that has been updated with new or replacement products <br />
:# Go to each additional DropBox location<br />
:# Delete the old copy rezzed out <br />
:# Replace with the new copy you just picked up <br />
:# Rez an upgradebee <br />
:# Wait for it to boot<br />
:# Click > select "Check All" <br />
:# Wait for it to run<br />
:# When it completes, simply delete the Bee<br />
<br />
You may see more numbers of objects it is checking than what you have/had rezzed out - this is normal, as a "check" will check ANYONE's, not just yours. It '''cannot''' do anything to anyone else's objects (and thus nobody else's upgrade bee can do anything to yours) - it just "pings" every CasperVend vendor or DropBox it knows WAS rezzed on the sim to see if it's still there.<br />
<br />
==== Last One Updated, First One Contacted ====<br />
----<br />
<br />
Usually, the last DropBox that gets updated with a new product is the one that the system tries to contact first.<br />
<br />
=== NOT On The Same Region ===<br />
----<br />
Having boxes containing the same item, on the '''same region''' is generally pointless. The goal behind having duplicate locations is to have reliability in case of sim/region-to-outside-world communication issues. Having all duplicate sets on the same sim/region means that they will all be affected when the sim/region goes out to lunch or runs out of URL's.<br />
<br />
=== On Different Regions ===<br />
----<br />
Having one or more duplicate DropBox(es) (DropBoxes containing the same items) on another region is '''absolutely recommended'''.<br />
<br />
Partly this is so that you have DropBoxes that work even when the simulator/region is down (especially if you have affiliate vendors out on the grid, or multiple locations) but also because simulators/regions occasionally "go dark" and refuse to talk to the outside world. The sim/region will still be up, inworld, and accessible to avatars even in this state, but because it's not talking to the outside world, DropBoxes on these affected sims/regions will be unable to deliver product to customers.<br />
<br />
Having one or more duplicate sets on other sims/regions reduces the chance that YOUR products won't deliver, when customers make a purchase or redeliver (thus making customers think you are no longer active as a merchant). These backup locations can be friend's homes, etc. <br />
<br />
There are also [https://wiki.casperdns.com/index.php/DropBox_Hosting DropBox Hosting services on the grid] that will allow you to rent a few prims just for DropBox purposes.<br />
<br />
= '''<span style="color:#00528c">DropBox Page on Website</span>''' =<br />
Your DropBoxes are now listed on the website, on the [https://wiki.casperdns.com/index.php/CasperVend_2/DropBoxes DropBoxes page]!<br />
<br />
The list is "colour coded" according to how long it's been since the site last contacted the dropbox. It does '''NOT''' mean that it's broken - deliveries will still happen. If you're concerned that it's shown with a colour background other than white, you may click the dropbox inworld and select "reset" - that'll make it contact the website and turn it white. It is '''NOT''' required that you do that - not being contacted doesn't mean it's not working. <br />
<br />
== The Columns ==<br />
:'''Last Seen:''' This is how long it's been since the website last talked to the dropbox. <br />
:'''Version:''' This is the script-reported version of the dropbox. An easy way to tell when you need to [[Current_Versions | check your versions]]. <br />
:'''Location:''' This is the listing of the sim, with a SLURL to the exact location where the DropBox is inworld. <br />
:'''Actions:''' You can "Manage" or view the "Contents" of the dropbox from this column. "Manage" gives you a page where you can ping, update, or delete the dropbox. "Contents" just shows you what's in it.<br />
<br />
== Colour Coding ==<br />
Yellow is for not being contacted for a short time. Pink is for not being contacted for a longer time. <br />
<br />
The variations in yellow and pink do not represent any specific timeframe, they alternate lighter and darker to make it easier for your eyes to follow a specific line.<br />
<br />
= '''<span style="color:#00528c">FAQ / Troubleshooting</span>''' =<br />
<br />
: '''Q. Why'd my vendors suddenly stop delivering notecards / demos / products?'''<br />
:: '''A.''' Things cannot be delivered if the system cannot find the dropbox, and/or cannot find the product items it's been told to send. Therefore, the first points to check are: <br />
::: * Is the item IN the dropbox? <br />
::: * Is the site pointing to the correct item(s)<br />
::: * Have you recently change name on the product / notecard / demo, without updating the website? <br />
::: * Has the sim/region "gone dark"? (If so, the only solution is restart the sim and/or have backup copies on at least one other sim/region.) <br />
::: * How many items are in your dropbox? (Remember if there are too many things in the dropbox, the SL servers seem to make stuff "go missing" - which would also prevent delivery of items.) <br />
::: * Also compare YOUR transaction log with the information in the '''[[CasperVend_2/Deliveries | Transactions & Deliveries]]''' page.<br />
<br />
: '''Q. My customers aren't getting the product after purchase, and the redelivery terminal keeps giving them a "Failed: Couldn't find delivery box for item on SLIFE. This merchant may no longer be using CasperVend." message, when it is, and I am.'''<br />
:: '''A1.''' Reset the DropBox(es). Use the touch menu first - if that doesn't work, then manually Edit > Reset scripts in selection to get them to actually reset. <br />
:: '''A2.''' If you have DropBox(es) on only one sim/region, then we strongly recommend having a backup set (see above) on at least one other sim/region location to reduce the risk of this happening again. <br />
<br />
: '''Q. I have a DropBox which shows as 'live' and as having __ items listed. However, when I open the drop box there are maybe half that amount of items showing inside the box.'''<br />
:: '''A.''' Casper Warden writes: "basically, if items have disappeared from the box, there's two possible reasons...<br />
::: '''1)''' they were no copy and were delivered<br />
::: '''2)''' your sim suffered an inventory failure or rollback<br />
:: in both circumstances the system isn't notified about the change :/ " <br />
:: When items that are no-copy to the merchant (such as breedable things) get sold, the # in the floaty text above the dropbox does NOT get updated.<br />
<br />
:'''Q. I got this message: "CasperVend DropBox: Items in the database seem to be out of sync! Re-uploading."'''<br />
:: '''A.''' Nothing to worry about - the system's self-check has determined that there is lag, either on the sim/region or in the grid itself. Once or twice per DropBox is normal (if you have multiple DropBoxes, you'll get several messages, but should just be one or two from each.) <br />
:: The only time to worry is when you get the message several times a day - that would indicate a sim/region communication problem, or that Casper is working on the backend servers. <br />
<br />
:'''Q. My last shop location is no more, I don't have access to it, and it keeps trying to send the OLD landmark. How can I fix this? '''<br />
:: '''A1.''' You'll need to edit *everywhere* you have it marked - usually this is in each and every single product listing - and set them up with the new landmark. <br />
:: '''A2.''' It is STRONGLY RECOMMENDED that you use a landmark name like '''"(your shop) - Main location"''' - rather than the default LL format that includes the sim/region name. Renaming your landmarks to something simple and WITHOUT the sim/region name means that when you have to move in the future, you can just outright swap the landmarks, without having to go through the hassle of updating every single product every time you change landmarks. <br />
<br />
:'''Q. I keep getting messages of "That item is no longer available or doesn't belong to you." when it is, and it does. '''<br />
:: '''A.''' Pick up and re-rez the DropBox, that should get rid of the spurious errors.</div>24607dde-d704-4db7-afa0-d9edc17c926chttps://wiki.casperdns.com/index.php?title=CasperVend_2/DropBoxes&diff=15327CasperVend 2/DropBoxes2023-08-31T18:11:33Z<p>24607dde-d704-4db7-afa0-d9edc17c926c: /* On Different Regions */</p>
<hr />
<div>{|align=right<br />
|__TOC__<br />
|}<br />
<br />
<!---- Keywords: product server ----> <br />
<br />
[[File:German_flag.gif]] [[CasperVend 2/DropBoxes/DE | Schaue hier in Deutsch!]]<br />
<br />
= '''<span style="color:#00528c">About the DropBox</span>''' =<br />
<br />
=== Current Version ===<br />
----<br />
Current version information may be '''[[Current_Versions | seen here]]'''. It's always a good idea to keep your dropbox(es) up to date, since version changes are quite often working around new bugs in sim communications that can cause failed deliveries.<br />
<br />
=== Debit Permissions - Version 2.70 and up ===<br />
----<br />
* '''Dropboxes now ask for debit permissions''' and may now be used to make payments for vendor refunds.<br />
* When an outgoing payment is made, the transaction URL will now appear in your Second Life transaction history instead of the object name, to help with tracking and avoid confusion when different objects are used for payments (See '''[https://wiki.casperdns.com/images/e/e9/CV_transaction_URL.png this image]''' for example.)<br />
* The "URL" warning should no longer occur on region restart ('''unless''' legitimate)<br />
<br />
See '''[https://wiki.casperdns.com/index.php/CasperVend_2/Vendors/ChangeLog#Dropboxes_and_debit_permissions Vendor Changelog]''' and '''[https://wiki.casperdns.com/index.php/Debit_Permissions Debit Permissions]''' pages for details.<br />
<br />
'''You will need to remain ON THE SIM/REGION while you are updating to v2.70, because of the need to answer the debit permissions windows!'''<br />
<br />
=== Limits ===<br />
----<br />
We recommend keeping the number of items in a dropbox below 200, the approximate number most people are comfortable with while waiting for the contents to load, with 400 being an upper limit in extreme cases. There have been issues reported with Second Life object inventories when people go substantially over these numbers.<br />
<br />
=== Moving / Returning DropBox ===<br />
----<br />
If your DropBox is accidentally returned to your inventory, simply rez it back out from your "Lost & Found" folder. No additional action needs to be taken once the DropBox is rezzed out once more; the site will pick up the contents automatically. <br />
<br />
If you need to move, simply follow these steps: <br />
:# Right-click DropBox<br />
:# Select "Take a copy" <br />
:# Click DropBox again<br />
:# Select "Delete" from popup menu<br />
:# Confirm delete (This will flush contents from website cache) <br />
:# Go to new location<br />
:# Rez copy of DropBox <br />
:# All set! <br />
<br />
=== Must Stay Rezzed ===<br />
----<br />
Your dropbox must be rezzed out - inworld - '''AT ALL TIMES''' or it cannot deliver your products, notecards, etc. to your customers.<br />
<br />
'''Remember:''' All Scripted delivery objects will not function if you do not rez them under the proper land group (when it is group land). DropBoxes are no exception. <br />
<br />
=== Placement ===<br />
----<br />
It doesn't matter where you put your DropBox. However, there are certain caveats you should be aware of:<br />
<br />
:# The land must let YOU run scripts - either enabled for all, or you are in the land group.<br />
:# You must have continual access, in order to add/remove products.<br />
<br />
=== Public or Private Land? ===<br />
----<br />
Other people cannot edit your dropboxes (unless you've given them "mod rights" on your stuff), so public locations are perfectly safe.<br />
<br />
However, please read the rental agreement / land covenant FOR that location so make sure dropboxes in general are allowed - because land managers/owners can still return objects, even if they can't do anything else to them. <br />
<br />
=== Renaming Your DropBoxes ===<br />
----<br />
By default, the "physical" name of your dropbox is something like:<br />
<br />
CasperVend DropBox v((version #))<br />
<br />
It's not only ok to rename your DropBox, it is '''strongly recommended''' - at least to include YOUR store name. The name of the DropBox your product comes from is seen in the delivery message that the customer receives - so be aware of that when renaming the box.<br />
<br />
Renaming is also recommended because if someone mutes "CasperVend DropBox v((version #))" from someone else, and YOUR DropBox name matches that, yours will get caught in that muting as well. <br />
<br />
=== Seeing your DropBoxes ===<br />
----<br />
<br />
DropBoxes are now listed on the CasperVend website, on the '''[https://caspervend.casperdns.com/dropboxes.php DropBoxes]''' page. <br />
<br />
This page shows you: <br />
:# Name of the DropBox <br />
:# Version number<br />
:# Sim location (clickable link to location inworld) <br />
:# Last contacted<br />
:# # of items in the DropBox<br />
:# Option to '''manage''' that specific DropBox and see the '''contents" <br />
<br />
At the top of that page you can also list "10, 20, 50, 100 or All" of your DropBoxes at once. The default is 10 per page.<br />
<br />
=== DropBox Address Message ===<br />
----<br />
<br />
The DropBox that responds to a request to deliver an object will send its physical location with the delivery message. <br />
<br />
This is a grid limitation by the Lindens and cannot be changed via scripting. This was instituted several years ago by the Lindens as an anti-griefing measure, to make it easier to report the location of a griefing object, and it applies to ALL objects across the grid that send messages. <br />
<br />
While you don't have to keep your DropBox in your store or rental headquarters, keep in mind that the occasional customer may unexpectedly drop in where the DropBox is located if they click the address link. You can set up a security orb (or banlines) if you wish on a '''private''' location, or just relocate the box(es) to a location where you don't mind customers occasionally dropping in.<br />
<br />
= '''<span style="color:#00528c">Using Your DropBox</span>''' =<br />
''The DropBox only '''seems''' no-modify in your inventory. This is due to the DropBox script being no-modify. Once you rez it out, the prim WILL be modifiable and allow you to add contents.''<br />
<br />
== '''<span style="color:#00528c">Organising Your Items</span>''' ==<br />
How you organize your DropBox contents is ENTIRELY up to you.<br />
<br />
:*It doesn't matter which items are in which box<br />
:*It doesn't matter where your box is in Second Life (caveats: see '''[[#DropBox_placement|Placement]]''').<br />
:* '''[[CasperVend_2/DropBoxes#Setting_Up_Duplicate_DropBoxes | Duplicate sets]]''' are always recommended<br />
<br />
There is one organisational limitation that you must always remember:<br />
<br />
:*Be careful to give '''all items''' a unique name. For example, '''don't''' name a texture the same as one of your items - If you have two different items with the exact same name (in different DropBoxes), the system '''may assume''' it is a second copy of the first item and may deliver ''either one''!<br />
<br />
And yes, capitalisation and typos count!<br />
<br />
== '''<span style="color:#00528c">CasperLet Specific Information</span>''' ==<br />
<br />
The bulk of this page is written with CasperVend and CasperUpdate in mind. <br />
<br />
While the DropBox within the CasperLet crate is the same thing (with the same script) that's in the CasperVend and CasperUpdate crate, CasperLet itself only uses notecards and landmarks. <br />
<br />
If you '''only''' use CasperLet, understand that you will only be loading notecards and landmarks in your DropBox, despite references in most of this page to "products". <br />
<br />
== '''<span style="color:#00528c">Loading Your Dropbox</span>''' ==<br />
<br />
:#Rez the DropBox out<br />
:#Right-click on the DropBox<br />
:#Select "Edit", then go to "Contents" tab. <br />
:#Drag your packaged items, textures and any notecards you have ready into the dropbox.<br />
:#Make sure that your notecards / landmarks / textures / packaged items are all named differently - if you name a texture the same as your object, for example, the vendor system will deliver - or redeliver - '''one''' of '''either''' of them. This means that if your customer pays for a packaged product, and your texture has the exact same name as your packaged product, the customer may get the texture '''instead''' of the packaged product.<br />
<br />
=== Cannot Share DropBoxes ===<br />
----<br />
'''The DropBox only recognizes the owner that unpacked it from the shipping crate.''' <br />
<br />
You cannot "share with group", it will not load other people's products. You cannot deed to a group, because the DropBox is no transfer. (And even if you could, it wouldn't work - the group would then be the owner, and the group isn't the one that purchased the copy of CasperVend that the DropBox came from...)<br />
<br />
=== No Folders ===<br />
----<br />
DropBoxes '''CANNOT''' accept a folder AS a folder - it will always assume the contents of the folders are separate products. If you have multiple items for one product, they need to go in '''THEIR OWN''' box / bag / shipping crate / package before going in the dropbox. Do not put an object named NYAN into the DropBox or strange things may happen...<br />
<br />
=== Your DropBox won't let you add things? ===<br />
----<br />
The grid is known for occasionally not letting things work as well as they should. Here are some troubleshooting points if it doesn't seem like the DropBox is letting you put stuff in it: <br />
<br />
: # Did you "lock" the dropbox (maybe to prevent accidently deleting it)? <br />
: # Has everything in the dropbox fully loaded in the edit / contents window? (SL usually won't let you add things until everything is loaded)<br />
: # Is SL not letting you do other things either? (may need to relog...)<br />
: # Try CTL + dragging the item from your inventory to the DropBox.<br />
: # Is it round or a box? If it's round, you've grabbed the "UpgradeBee DROPBOXES ONLY" by mistake, and that will ALWAYS be no-mod. Search for '''"CasperTech DropBox"''' instead.<br />
<br />
=== "How do I connect the DropBox to...." ===<br />
----<br />
<br />
You don't. All the dropboxes work as inworld "cloud/pool storage" for deliveries - this is why duplicate sets are such a good idea. There's no need to even try to "pin" a dropbox to a specific vendor, the system will automatically pull a product for delivery from the first dropbox that (1) responds, and (2) HAS the item being requested.<br />
<br />
== '''<span style="color:#00528c">Updating Your DropBox</span>''' ==<br />
<br />
=== Updating With New Products ===<br />
----<br />
The SL grid does not allow one object to load inventory into another object in a different sim/region. You must manually add each of your new packaged products to '''EACH''' DropBox you want them to be in. "Cloud/pool" only applies to '''deliveries''' for customer purchases.<br />
<br />
=== Updating DropBox Version ===<br />
----<br />
See '''[[CasperVend_2/DropBoxes#Upgrading_Your_DropBoxes | this section]]'''<br />
<br />
== '''<span style="color:#00528c">Products Not Showing On Site?</span>''' ==<br />
There are '''four''' common principles behind why product packages may not show up on the website to be added to a new listing. They are: <br />
<br />
: 1) DropBox cannot be contacted<br />
: 2) Duplicated name of notecard/texture/etc. <br />
: 3) Product is "(no transfer)" to YOU, the merchant-owner<br />
: 4) Product is not in the dropbox<br />
<br />
There is also one big reason why product packages don't show on the '''PRODUCTS''' page itself, '''OR''' in the list of products to add to a profile: <br />
: 5) Products have not had a '''[[CasperVend_2/Product_Options | product listing]]''' created yet<br />
<br />
=== Can't be contacted ===<br />
----<br />
Common error points when the DropBox(es) can't be contacted are: <br />
# DropBox(es) not rezzed out (Like all scripted inworld delivery systems, they cannot deliver if not rezzed out...) <br />
# DropBox(es) has no script (need "CasperTech Dropbox" script to stay in the box) <br />
# The sim the DropBox(es) is(are) on is having a snit and not talking to the outside world (the "gone dark" issue mentioned in the backup section below) <br />
<br />
=== Duplicated Names ===<br />
----<br />
Common error is that the product name exactly matches the name of a texture or notecard. <br />
<br />
The popup for product selection is set to filter out duplicates - so this results in new products not showing because the texture or notecard is showing instead. <br />
<br />
# Rename your product package, corresponding notecard, and corresponding texture so that the names are '''ALL''' different from each other.<br />
<br />
=== Product is "no transfer" ===<br />
----<br />
Products MAY end up being effectively "(no transfer)" to you for different reasons: <br />
# Putting a holo demo in the DropBox instead of the holovendor<br />
# An errant script, texture, or other "(no transfer)" item included with the product by accident. (Might be accidentally linked to a build, or accidentally dropped in the contents of a prim.)<br />
<br />
Verify that all your items are transferable TO YOU by looking in the contents of (each) DropBox, waiting for the contents to load, and scrolling the list to the right to see the permissions. Scroll down to see everything in the DropBox and verify whether or not "(no transfer)" is next to any of the items.<br />
<br />
=== Not in the dropbox ===<br />
----<br />
# Did you forget to put it in the dropbox? <br />
# Did you perhaps put the product in the vendor instead of the DropBox?<br />
# When you rezzed (or re-rezzed) the DropBox, did you rez an older version that's missing the new item(s)?<br />
<br />
== '''<span style="color:#00528c">Products Not Showing On Products Page? </span>''' ==<br />
<br />
You won't see '''anything''' on the product page until a listing has been created for the product(s) in question. <br />
<br />
CasperVend does not show product '''packages''' on the '''[https://caspervend.casperdns.com/productsNew.php Products page]''', only completed product '''listings'''. <br />
<br />
You must create your product listings - if all goes well (see previous section for common troubleshooting points) then you'll see your missing packages in the popup for selecting a package to deliver, once you start creating your product listing. <br />
<br />
Start at #9 '''[[CasperVend_2/Quick_Start | on this page]]''' to create your product listings.<br />
<br />
=== Product Selector Popup Not Appearing On Website? ===<br />
----<br />
You may have a browser extension that's blocking the popup product picker window. <br />
<br />
If you are using Chrome, you can start another Chrome window in 'Incognito" mode - use CTL + SHFT + N to start an Incognito window. This disables all the extensions before logging you in. <br />
<br />
If you are using Firefox (or another browser) with a a "no javascript" type extension that allows a temporary override, you need to allow '''casperdns.com''' and '''ajax.googleapis.com''' to be able to see the product picker popup window.<br />
<br />
= '''<span style="color:#00528c">Upgrading Your DropBoxes</span>''' =<br />
:# Verify version: Click the DropBox, and from the popup menu, select "Version".<br />
:# Compare with the list on the '''[[Current_Versions | versions page]]'''.<br />
:# If your DropBox is out of date, '''redeliver''' the pack that your dropbox came from. (Old Bee only has old version.)<br />
:# Once you have a redelivered shipping crate, unpack that.<br />
:# Pull out the '''NEW''' UpgradeBee DROPBOXES ONLY.<br />
:# Rez one in each sim/region you have DropBox(es), and select '''RUN UPDATE'''. <br />
:# The UpgradeBee will fly around and update all of your DropBox(es).<br />
<br />
If you get an error message for "Illegal Task" '''or''' "0 attempted / 0 upgraded / 0 no longer exist / 0 weren't upgraded because..." message, then click the dropbox, and from the popup menu, select "Reset". <br />
<br />
=== "I Don't Have That Many Vendors Out!" ===<br />
----<br />
When you use the "check all" function, it will check '''everyone's''' vendors AND dropboxes on the sim. <br />
<br />
This is normal! <br />
<br />
It cannot actually upgrade anything that's not YOURS - but it will ping CasperVend things from everyone on the sim and see if the items are still rezzed out. <br />
<br />
=== Verifying the update worked ===<br />
----<br />
:* Click the DropBox. <br />
:* Select "Version" from the popup.<br />
:* (If you don't have "version" as an option, they need to be upgraded...) <br />
:* The DropBox will tell you its version in local chat. <br />
<br />
The DropBox '''prim''' will not be renamed by the UpgradeBee - this is normal. If you want the object name to reflect the version, you must rename it manually.<br />
<br />
= '''<span style="color:#00528c">Delivery Errors</span>''' =<br />
<br />
See the '''[[CasperVend_2/Deliveries#Delivery_Errors | delivery errors section]]''' on the transactions page.<br />
<br />
= '''<span style="color:#00528c">E-Mail Self Test Yellow Text Message</span>''' =<br />
:: '''''WARNING: This dropbox failed its e-mail self-test. This means that the box may become uncontactable, which may affect your deliveries. Please pick up this box and re-rez it.'''''<br />
<br />
This is a test feature new with version 2.27 - it's designed to let you know when the sim has blacklisted the dropbox in question. <br />
<br />
Make sure your DropBox is on the '''[[Current_Versions | latest version.]]''' If it's not, then follow '''[[CasperVend_2/DropBoxes#Updating_DropBox_Version | these instructions]]''' to get it up to date.<br />
<br />
This message '''has been removed in current versions.''' If you see any variant of this message, it means your DropBox is '''NOT''' up to date!<br />
<br />
= '''<span style="color:#00528c">Cleanly Deleting Old DropBoxes</span>''' =<br />
'''Properly''' deleting an older (or unused) DropBox is '''essential''' for a cleaner database - following these steps means that the DropBox will flush its contents out of the database before deleting itself. <br />
<br />
'''Remember to "take a copy" FIRST!'''<br />
<br />
# Click the DropBox<br />
# Select "Delete" from the popup menu<br />
# The DropBox will give you a confirmation screen; if you really want to delete it, click the appropriate option<br />
# The DropBox will clear its contents out of the website, before deleting itself inworld<br />
<br />
=== Products Showing That No Longer Exist? ===<br />
----<br />
This issue is most often caused by simply using "Edit > Delete" on an existing DropBox, '''OR''' a DropBox is accidentally returned to your lost & found folder. <br />
<br />
Here's the way to fix this: <br />
<br />
:# Log in to the CasperVend website<br />
:# Go to the '''[https://caspervend.casperdns.com/dropboxes.php DropBoxes page]'''<br />
:# You will see a list of all the DropBoxes the system thinks are still rezzed inworld. <br />
:# Click the '''"contents"''' link next to each dropbox and look through the contents<br />
:# When you find the incorrect dropbox, click '''"Manage"''' on the same line<br />
:# You will be taken to another page<br />
:# To delete that dropbox, select '''"Delete Unit"'''<br />
:# You will get a confirmation popup - click "ok"<br />
:# The system will process, and then reload the main DropBoxes page<br />
<br />
=== Accidentally Returned/Picked Up ===<br />
----<br />
Simply re-rez the DropBox. Your vendors will resume normal delivery operations without needing to touch anything on the website.<br />
<br />
= '''<span style="color:#00528c">The "DropBox Cloud"</span>''' =<br />
<br />
All DropBox(es) you have rezzed anywhere on the grid contribute to the "global product cloud" of your products. This is why it doesn't matter where you're dropboxes are, as long as they are rezzed inworld. <br />
<br />
The website will deliver '''one''' copy of the configured item, from '''the first available''' DropBox that has that product, AND responds in a timely manner. Due to general grid crappiness, sometimes a sim/region doesn't respond as well as it should - and having duplicates on different sims/regions means that the website has the opportunity to use other dropboxes for the delivery of that item instead of completely failing. <br />
<br />
So yes, multiple / duplicate / backup DropBox(es) are not only totally ok, they are actually encouraged!<br />
<br />
== '''<span style="color:#00528c">Setting Up Duplicate DropBoxes</span>''' ==<br />
You may think "backup sets", but it's really "duplicate sets" - the system does not seek out one set as a primary, the dropboxes send the product from (1) the first one to respond to the deliver command, that (2) has the product. If that's on your home sim, then that's where it comes from. If the first one to respond is one of your duplicated locations, then that's where it gets sent from. <br />
<br />
If you like, and you have multiple locations for your DropBoxes, you can work with ONE set as a "master set" of DropBoxes. Then, when you are done adding things in a particular session, simply do the following steps: <br />
<br />
# Right-click, then "Take a copy" of your existing DropBox(es)<br />
# Go to another sim/region where you have long-term rez rights. (If you're Premium and have a free parcel allowance, this would also be an ideal location. Please note that dropboxes are not allowed on Linden Homes, and please always check the covenant of the land you're using.) <br />
# Rez out the DropBox(es)<br />
# Wait for the DropBox(es) to talk to the website. <br />
# All set! Remember to leave the DropBox(es) rezzed at all times. <br />
<br />
You may organize your DropBoxes however you'd like, and you can rez however many you'd like (up to the maxmium prim/impact limits of the parcel, of course). <br />
<br />
=== Updating Duplicate DropBox(es) ===<br />
----<br />
If you want the products in all of your DropBox(es) to stay updated compared to each other, you will, unfortunately, need to do that manually. <br />
<br />
You can "designate" one set of DropBox(es) as your "master set" - this is NOT a scripted setting, and NOT something you do on the website, but in this case simply refers to the set that you update FIRST - whether you have it on your build platform (and set up an orb to keep random people from dropping in) or hanging out in your store is up to you. <br />
<br />
There are two ways of doing this: <br />
<br />
==== Adding Individual New Products ====<br />
----<br />
<br />
:# Go to each DropBox location<br />
:# Add the new product(s) to each pertinent DropBox<br />
<br />
If replacing old products, rather than just adding new: <br />
<br />
:# Go to each DropBox location<br />
:# Delete the old copy of the product you are replacing<br />
:# Replace with the new product<br />
<br />
Go around to all dropbox locations and add the new products to the pertinent DropBox(es) via Right-Click > Edit > Contents tab<br />
<br />
==== Replacing Older DropBox(es) ====<br />
---- <br />
<br />
:# Right-click > "Take a copy" of each dropbox that has been updated with new or replacement products <br />
:# Go to each additional DropBox location<br />
:# Delete the old copy rezzed out <br />
:# Replace with the new copy you just picked up <br />
:# Rez an upgradebee <br />
:# Wait for it to boot<br />
:# Click > select "Check All" <br />
:# Wait for it to run<br />
:# When it completes, simply delete the Bee<br />
<br />
You may see more numbers of objects it is checking than what you have/had rezzed out - this is normal, as a "check" will check ANYONE's, not just yours. It '''cannot''' do anything to anyone else's objects (and thus nobody else's upgrade bee can do anything to yours) - it just "pings" every CasperVend vendor or DropBox it knows WAS rezzed on the sim to see if it's still there.<br />
<br />
==== Last One Updated, First One Contacted ====<br />
----<br />
<br />
Usually, the last DropBox that gets updated with a new product is the one that the system tries to contact first.<br />
<br />
=== NOT On The Same Region ===<br />
----<br />
Having boxes containing the same item, on the '''same region''' is generally pointless. The goal behind having duplicate locations is to have reliability in case of sim/region-to-outside-world communication issues. Having all duplicate sets on the same sim/region means that they will all be affected when the sim/region goes out to lunch or runs out of URL's.<br />
<br />
=== On Different Regions ===<br />
----<br />
Having one or more duplicate DropBox(es) (DropBoxes containing the same items) on another region is '''absolutely recommended'''.<br />
<br />
Partly this is so that you have DropBoxes that work even when the simulator/region is down (especially if you have affiliate vendors out on the grid, or multiple locations) but also because simulators/regions occasionally "go dark" and refuse to talk to the outside world. The sim/region will still be up, inworld, and accessible to avatars even in this state, but because it's not talking to the outside world, DropBoxes on these affected sims/regions will be unable to deliver product to customers.<br />
<br />
Having one or more backup sets on other sims/regions reduces the chance that YOUR products won't deliver when customers make a purchase. These backup locations can be friend's homes, etc. <br />
<br />
There are also [https://wiki.casperdns.com/index.php/DropBox_Hosting DropBox Hosting services on the grid] that will allow you to rent a few prims just for DropBox purposes.<br />
<br />
= '''<span style="color:#00528c">DropBox Page on Website</span>''' =<br />
Your DropBoxes are now listed on the website, on the [https://wiki.casperdns.com/index.php/CasperVend_2/DropBoxes DropBoxes page]!<br />
<br />
The list is "colour coded" according to how long it's been since the site last contacted the dropbox. It does '''NOT''' mean that it's broken - deliveries will still happen. If you're concerned that it's shown with a colour background other than white, you may click the dropbox inworld and select "reset" - that'll make it contact the website and turn it white. It is '''NOT''' required that you do that - not being contacted doesn't mean it's not working. <br />
<br />
== The Columns ==<br />
:'''Last Seen:''' This is how long it's been since the website last talked to the dropbox. <br />
:'''Version:''' This is the script-reported version of the dropbox. An easy way to tell when you need to [[Current_Versions | check your versions]]. <br />
:'''Location:''' This is the listing of the sim, with a SLURL to the exact location where the DropBox is inworld. <br />
:'''Actions:''' You can "Manage" or view the "Contents" of the dropbox from this column. "Manage" gives you a page where you can ping, update, or delete the dropbox. "Contents" just shows you what's in it.<br />
<br />
== Colour Coding ==<br />
Yellow is for not being contacted for a short time. Pink is for not being contacted for a longer time. <br />
<br />
The variations in yellow and pink do not represent any specific timeframe, they alternate lighter and darker to make it easier for your eyes to follow a specific line.<br />
<br />
= '''<span style="color:#00528c">FAQ / Troubleshooting</span>''' =<br />
<br />
: '''Q. Why'd my vendors suddenly stop delivering notecards / demos / products?'''<br />
:: '''A.''' Things cannot be delivered if the system cannot find the dropbox, and/or cannot find the product items it's been told to send. Therefore, the first points to check are: <br />
::: * Is the item IN the dropbox? <br />
::: * Is the site pointing to the correct item(s)<br />
::: * Have you recently change name on the product / notecard / demo, without updating the website? <br />
::: * Has the sim/region "gone dark"? (If so, the only solution is restart the sim and/or have backup copies on at least one other sim/region.) <br />
::: * How many items are in your dropbox? (Remember if there are too many things in the dropbox, the SL servers seem to make stuff "go missing" - which would also prevent delivery of items.) <br />
::: * Also compare YOUR transaction log with the information in the '''[[CasperVend_2/Deliveries | Transactions & Deliveries]]''' page.<br />
<br />
: '''Q. My customers aren't getting the product after purchase, and the redelivery terminal keeps giving them a "Failed: Couldn't find delivery box for item on SLIFE. This merchant may no longer be using CasperVend." message, when it is, and I am.'''<br />
:: '''A1.''' Reset the DropBox(es). Use the touch menu first - if that doesn't work, then manually Edit > Reset scripts in selection to get them to actually reset. <br />
:: '''A2.''' If you have DropBox(es) on only one sim/region, then we strongly recommend having a backup set (see above) on at least one other sim/region location to reduce the risk of this happening again. <br />
<br />
: '''Q. I have a DropBox which shows as 'live' and as having __ items listed. However, when I open the drop box there are maybe half that amount of items showing inside the box.'''<br />
:: '''A.''' Casper Warden writes: "basically, if items have disappeared from the box, there's two possible reasons...<br />
::: '''1)''' they were no copy and were delivered<br />
::: '''2)''' your sim suffered an inventory failure or rollback<br />
:: in both circumstances the system isn't notified about the change :/ " <br />
:: When items that are no-copy to the merchant (such as breedable things) get sold, the # in the floaty text above the dropbox does NOT get updated.<br />
<br />
:'''Q. I got this message: "CasperVend DropBox: Items in the database seem to be out of sync! Re-uploading."'''<br />
:: '''A.''' Nothing to worry about - the system's self-check has determined that there is lag, either on the sim/region or in the grid itself. Once or twice per DropBox is normal (if you have multiple DropBoxes, you'll get several messages, but should just be one or two from each.) <br />
:: The only time to worry is when you get the message several times a day - that would indicate a sim/region communication problem, or that Casper is working on the backend servers. <br />
<br />
:'''Q. My last shop location is no more, I don't have access to it, and it keeps trying to send the OLD landmark. How can I fix this? '''<br />
:: '''A1.''' You'll need to edit *everywhere* you have it marked - usually this is in each and every single product listing - and set them up with the new landmark. <br />
:: '''A2.''' It is STRONGLY RECOMMENDED that you use a landmark name like '''"(your shop) - Main location"''' - rather than the default LL format that includes the sim/region name. Renaming your landmarks to something simple and WITHOUT the sim/region name means that when you have to move in the future, you can just outright swap the landmarks, without having to go through the hassle of updating every single product every time you change landmarks. <br />
<br />
:'''Q. I keep getting messages of "That item is no longer available or doesn't belong to you." when it is, and it does. '''<br />
:: '''A.''' Pick up and re-rez the DropBox, that should get rid of the spurious errors.</div>24607dde-d704-4db7-afa0-d9edc17c926chttps://wiki.casperdns.com/index.php?title=CasperVend_2/DropBoxes&diff=15326CasperVend 2/DropBoxes2023-08-31T18:07:40Z<p>24607dde-d704-4db7-afa0-d9edc17c926c: /* On Different Regions */</p>
<hr />
<div>{|align=right<br />
|__TOC__<br />
|}<br />
<br />
<!---- Keywords: product server ----> <br />
<br />
[[File:German_flag.gif]] [[CasperVend 2/DropBoxes/DE | Schaue hier in Deutsch!]]<br />
<br />
= '''<span style="color:#00528c">About the DropBox</span>''' =<br />
<br />
=== Current Version ===<br />
----<br />
Current version information may be '''[[Current_Versions | seen here]]'''. It's always a good idea to keep your dropbox(es) up to date, since version changes are quite often working around new bugs in sim communications that can cause failed deliveries.<br />
<br />
=== Debit Permissions - Version 2.70 and up ===<br />
----<br />
* '''Dropboxes now ask for debit permissions''' and may now be used to make payments for vendor refunds.<br />
* When an outgoing payment is made, the transaction URL will now appear in your Second Life transaction history instead of the object name, to help with tracking and avoid confusion when different objects are used for payments (See '''[https://wiki.casperdns.com/images/e/e9/CV_transaction_URL.png this image]''' for example.)<br />
* The "URL" warning should no longer occur on region restart ('''unless''' legitimate)<br />
<br />
See '''[https://wiki.casperdns.com/index.php/CasperVend_2/Vendors/ChangeLog#Dropboxes_and_debit_permissions Vendor Changelog]''' and '''[https://wiki.casperdns.com/index.php/Debit_Permissions Debit Permissions]''' pages for details.<br />
<br />
'''You will need to remain ON THE SIM/REGION while you are updating to v2.70, because of the need to answer the debit permissions windows!'''<br />
<br />
=== Limits ===<br />
----<br />
We recommend keeping the number of items in a dropbox below 200, the approximate number most people are comfortable with while waiting for the contents to load, with 400 being an upper limit in extreme cases. There have been issues reported with Second Life object inventories when people go substantially over these numbers.<br />
<br />
=== Moving / Returning DropBox ===<br />
----<br />
If your DropBox is accidentally returned to your inventory, simply rez it back out from your "Lost & Found" folder. No additional action needs to be taken once the DropBox is rezzed out once more; the site will pick up the contents automatically. <br />
<br />
If you need to move, simply follow these steps: <br />
:# Right-click DropBox<br />
:# Select "Take a copy" <br />
:# Click DropBox again<br />
:# Select "Delete" from popup menu<br />
:# Confirm delete (This will flush contents from website cache) <br />
:# Go to new location<br />
:# Rez copy of DropBox <br />
:# All set! <br />
<br />
=== Must Stay Rezzed ===<br />
----<br />
Your dropbox must be rezzed out - inworld - '''AT ALL TIMES''' or it cannot deliver your products, notecards, etc. to your customers.<br />
<br />
'''Remember:''' All Scripted delivery objects will not function if you do not rez them under the proper land group (when it is group land). DropBoxes are no exception. <br />
<br />
=== Placement ===<br />
----<br />
It doesn't matter where you put your DropBox. However, there are certain caveats you should be aware of:<br />
<br />
:# The land must let YOU run scripts - either enabled for all, or you are in the land group.<br />
:# You must have continual access, in order to add/remove products.<br />
<br />
=== Public or Private Land? ===<br />
----<br />
Other people cannot edit your dropboxes (unless you've given them "mod rights" on your stuff), so public locations are perfectly safe.<br />
<br />
However, please read the rental agreement / land covenant FOR that location so make sure dropboxes in general are allowed - because land managers/owners can still return objects, even if they can't do anything else to them. <br />
<br />
=== Renaming Your DropBoxes ===<br />
----<br />
By default, the "physical" name of your dropbox is something like:<br />
<br />
CasperVend DropBox v((version #))<br />
<br />
It's not only ok to rename your DropBox, it is '''strongly recommended''' - at least to include YOUR store name. The name of the DropBox your product comes from is seen in the delivery message that the customer receives - so be aware of that when renaming the box.<br />
<br />
Renaming is also recommended because if someone mutes "CasperVend DropBox v((version #))" from someone else, and YOUR DropBox name matches that, yours will get caught in that muting as well. <br />
<br />
=== Seeing your DropBoxes ===<br />
----<br />
<br />
DropBoxes are now listed on the CasperVend website, on the '''[https://caspervend.casperdns.com/dropboxes.php DropBoxes]''' page. <br />
<br />
This page shows you: <br />
:# Name of the DropBox <br />
:# Version number<br />
:# Sim location (clickable link to location inworld) <br />
:# Last contacted<br />
:# # of items in the DropBox<br />
:# Option to '''manage''' that specific DropBox and see the '''contents" <br />
<br />
At the top of that page you can also list "10, 20, 50, 100 or All" of your DropBoxes at once. The default is 10 per page.<br />
<br />
=== DropBox Address Message ===<br />
----<br />
<br />
The DropBox that responds to a request to deliver an object will send its physical location with the delivery message. <br />
<br />
This is a grid limitation by the Lindens and cannot be changed via scripting. This was instituted several years ago by the Lindens as an anti-griefing measure, to make it easier to report the location of a griefing object, and it applies to ALL objects across the grid that send messages. <br />
<br />
While you don't have to keep your DropBox in your store or rental headquarters, keep in mind that the occasional customer may unexpectedly drop in where the DropBox is located if they click the address link. You can set up a security orb (or banlines) if you wish on a '''private''' location, or just relocate the box(es) to a location where you don't mind customers occasionally dropping in.<br />
<br />
= '''<span style="color:#00528c">Using Your DropBox</span>''' =<br />
''The DropBox only '''seems''' no-modify in your inventory. This is due to the DropBox script being no-modify. Once you rez it out, the prim WILL be modifiable and allow you to add contents.''<br />
<br />
== '''<span style="color:#00528c">Organising Your Items</span>''' ==<br />
How you organize your DropBox contents is ENTIRELY up to you.<br />
<br />
:*It doesn't matter which items are in which box<br />
:*It doesn't matter where your box is in Second Life (caveats: see '''[[#DropBox_placement|Placement]]''').<br />
:* '''[[CasperVend_2/DropBoxes#Setting_Up_Duplicate_DropBoxes | Duplicate sets]]''' are always recommended<br />
<br />
There is one organisational limitation that you must always remember:<br />
<br />
:*Be careful to give '''all items''' a unique name. For example, '''don't''' name a texture the same as one of your items - If you have two different items with the exact same name (in different DropBoxes), the system '''may assume''' it is a second copy of the first item and may deliver ''either one''!<br />
<br />
And yes, capitalisation and typos count!<br />
<br />
== '''<span style="color:#00528c">CasperLet Specific Information</span>''' ==<br />
<br />
The bulk of this page is written with CasperVend and CasperUpdate in mind. <br />
<br />
While the DropBox within the CasperLet crate is the same thing (with the same script) that's in the CasperVend and CasperUpdate crate, CasperLet itself only uses notecards and landmarks. <br />
<br />
If you '''only''' use CasperLet, understand that you will only be loading notecards and landmarks in your DropBox, despite references in most of this page to "products". <br />
<br />
== '''<span style="color:#00528c">Loading Your Dropbox</span>''' ==<br />
<br />
:#Rez the DropBox out<br />
:#Right-click on the DropBox<br />
:#Select "Edit", then go to "Contents" tab. <br />
:#Drag your packaged items, textures and any notecards you have ready into the dropbox.<br />
:#Make sure that your notecards / landmarks / textures / packaged items are all named differently - if you name a texture the same as your object, for example, the vendor system will deliver - or redeliver - '''one''' of '''either''' of them. This means that if your customer pays for a packaged product, and your texture has the exact same name as your packaged product, the customer may get the texture '''instead''' of the packaged product.<br />
<br />
=== Cannot Share DropBoxes ===<br />
----<br />
'''The DropBox only recognizes the owner that unpacked it from the shipping crate.''' <br />
<br />
You cannot "share with group", it will not load other people's products. You cannot deed to a group, because the DropBox is no transfer. (And even if you could, it wouldn't work - the group would then be the owner, and the group isn't the one that purchased the copy of CasperVend that the DropBox came from...)<br />
<br />
=== No Folders ===<br />
----<br />
DropBoxes '''CANNOT''' accept a folder AS a folder - it will always assume the contents of the folders are separate products. If you have multiple items for one product, they need to go in '''THEIR OWN''' box / bag / shipping crate / package before going in the dropbox. Do not put an object named NYAN into the DropBox or strange things may happen...<br />
<br />
=== Your DropBox won't let you add things? ===<br />
----<br />
The grid is known for occasionally not letting things work as well as they should. Here are some troubleshooting points if it doesn't seem like the DropBox is letting you put stuff in it: <br />
<br />
: # Did you "lock" the dropbox (maybe to prevent accidently deleting it)? <br />
: # Has everything in the dropbox fully loaded in the edit / contents window? (SL usually won't let you add things until everything is loaded)<br />
: # Is SL not letting you do other things either? (may need to relog...)<br />
: # Try CTL + dragging the item from your inventory to the DropBox.<br />
: # Is it round or a box? If it's round, you've grabbed the "UpgradeBee DROPBOXES ONLY" by mistake, and that will ALWAYS be no-mod. Search for '''"CasperTech DropBox"''' instead.<br />
<br />
=== "How do I connect the DropBox to...." ===<br />
----<br />
<br />
You don't. All the dropboxes work as inworld "cloud/pool storage" for deliveries - this is why duplicate sets are such a good idea. There's no need to even try to "pin" a dropbox to a specific vendor, the system will automatically pull a product for delivery from the first dropbox that (1) responds, and (2) HAS the item being requested.<br />
<br />
== '''<span style="color:#00528c">Updating Your DropBox</span>''' ==<br />
<br />
=== Updating With New Products ===<br />
----<br />
The SL grid does not allow one object to load inventory into another object in a different sim/region. You must manually add each of your new packaged products to '''EACH''' DropBox you want them to be in. "Cloud/pool" only applies to '''deliveries''' for customer purchases.<br />
<br />
=== Updating DropBox Version ===<br />
----<br />
See '''[[CasperVend_2/DropBoxes#Upgrading_Your_DropBoxes | this section]]'''<br />
<br />
== '''<span style="color:#00528c">Products Not Showing On Site?</span>''' ==<br />
There are '''four''' common principles behind why product packages may not show up on the website to be added to a new listing. They are: <br />
<br />
: 1) DropBox cannot be contacted<br />
: 2) Duplicated name of notecard/texture/etc. <br />
: 3) Product is "(no transfer)" to YOU, the merchant-owner<br />
: 4) Product is not in the dropbox<br />
<br />
There is also one big reason why product packages don't show on the '''PRODUCTS''' page itself, '''OR''' in the list of products to add to a profile: <br />
: 5) Products have not had a '''[[CasperVend_2/Product_Options | product listing]]''' created yet<br />
<br />
=== Can't be contacted ===<br />
----<br />
Common error points when the DropBox(es) can't be contacted are: <br />
# DropBox(es) not rezzed out (Like all scripted inworld delivery systems, they cannot deliver if not rezzed out...) <br />
# DropBox(es) has no script (need "CasperTech Dropbox" script to stay in the box) <br />
# The sim the DropBox(es) is(are) on is having a snit and not talking to the outside world (the "gone dark" issue mentioned in the backup section below) <br />
<br />
=== Duplicated Names ===<br />
----<br />
Common error is that the product name exactly matches the name of a texture or notecard. <br />
<br />
The popup for product selection is set to filter out duplicates - so this results in new products not showing because the texture or notecard is showing instead. <br />
<br />
# Rename your product package, corresponding notecard, and corresponding texture so that the names are '''ALL''' different from each other.<br />
<br />
=== Product is "no transfer" ===<br />
----<br />
Products MAY end up being effectively "(no transfer)" to you for different reasons: <br />
# Putting a holo demo in the DropBox instead of the holovendor<br />
# An errant script, texture, or other "(no transfer)" item included with the product by accident. (Might be accidentally linked to a build, or accidentally dropped in the contents of a prim.)<br />
<br />
Verify that all your items are transferable TO YOU by looking in the contents of (each) DropBox, waiting for the contents to load, and scrolling the list to the right to see the permissions. Scroll down to see everything in the DropBox and verify whether or not "(no transfer)" is next to any of the items.<br />
<br />
=== Not in the dropbox ===<br />
----<br />
# Did you forget to put it in the dropbox? <br />
# Did you perhaps put the product in the vendor instead of the DropBox?<br />
# When you rezzed (or re-rezzed) the DropBox, did you rez an older version that's missing the new item(s)?<br />
<br />
== '''<span style="color:#00528c">Products Not Showing On Products Page? </span>''' ==<br />
<br />
You won't see '''anything''' on the product page until a listing has been created for the product(s) in question. <br />
<br />
CasperVend does not show product '''packages''' on the '''[https://caspervend.casperdns.com/productsNew.php Products page]''', only completed product '''listings'''. <br />
<br />
You must create your product listings - if all goes well (see previous section for common troubleshooting points) then you'll see your missing packages in the popup for selecting a package to deliver, once you start creating your product listing. <br />
<br />
Start at #9 '''[[CasperVend_2/Quick_Start | on this page]]''' to create your product listings.<br />
<br />
=== Product Selector Popup Not Appearing On Website? ===<br />
----<br />
You may have a browser extension that's blocking the popup product picker window. <br />
<br />
If you are using Chrome, you can start another Chrome window in 'Incognito" mode - use CTL + SHFT + N to start an Incognito window. This disables all the extensions before logging you in. <br />
<br />
If you are using Firefox (or another browser) with a a "no javascript" type extension that allows a temporary override, you need to allow '''casperdns.com''' and '''ajax.googleapis.com''' to be able to see the product picker popup window.<br />
<br />
= '''<span style="color:#00528c">Upgrading Your DropBoxes</span>''' =<br />
:# Verify version: Click the DropBox, and from the popup menu, select "Version".<br />
:# Compare with the list on the '''[[Current_Versions | versions page]]'''.<br />
:# If your DropBox is out of date, '''redeliver''' the pack that your dropbox came from. (Old Bee only has old version.)<br />
:# Once you have a redelivered shipping crate, unpack that.<br />
:# Pull out the '''NEW''' UpgradeBee DROPBOXES ONLY.<br />
:# Rez one in each sim/region you have DropBox(es), and select '''RUN UPDATE'''. <br />
:# The UpgradeBee will fly around and update all of your DropBox(es).<br />
<br />
If you get an error message for "Illegal Task" '''or''' "0 attempted / 0 upgraded / 0 no longer exist / 0 weren't upgraded because..." message, then click the dropbox, and from the popup menu, select "Reset". <br />
<br />
=== "I Don't Have That Many Vendors Out!" ===<br />
----<br />
When you use the "check all" function, it will check '''everyone's''' vendors AND dropboxes on the sim. <br />
<br />
This is normal! <br />
<br />
It cannot actually upgrade anything that's not YOURS - but it will ping CasperVend things from everyone on the sim and see if the items are still rezzed out. <br />
<br />
=== Verifying the update worked ===<br />
----<br />
:* Click the DropBox. <br />
:* Select "Version" from the popup.<br />
:* (If you don't have "version" as an option, they need to be upgraded...) <br />
:* The DropBox will tell you its version in local chat. <br />
<br />
The DropBox '''prim''' will not be renamed by the UpgradeBee - this is normal. If you want the object name to reflect the version, you must rename it manually.<br />
<br />
= '''<span style="color:#00528c">Delivery Errors</span>''' =<br />
<br />
See the '''[[CasperVend_2/Deliveries#Delivery_Errors | delivery errors section]]''' on the transactions page.<br />
<br />
= '''<span style="color:#00528c">E-Mail Self Test Yellow Text Message</span>''' =<br />
:: '''''WARNING: This dropbox failed its e-mail self-test. This means that the box may become uncontactable, which may affect your deliveries. Please pick up this box and re-rez it.'''''<br />
<br />
This is a test feature new with version 2.27 - it's designed to let you know when the sim has blacklisted the dropbox in question. <br />
<br />
Make sure your DropBox is on the '''[[Current_Versions | latest version.]]''' If it's not, then follow '''[[CasperVend_2/DropBoxes#Updating_DropBox_Version | these instructions]]''' to get it up to date.<br />
<br />
This message '''has been removed in current versions.''' If you see any variant of this message, it means your DropBox is '''NOT''' up to date!<br />
<br />
= '''<span style="color:#00528c">Cleanly Deleting Old DropBoxes</span>''' =<br />
'''Properly''' deleting an older (or unused) DropBox is '''essential''' for a cleaner database - following these steps means that the DropBox will flush its contents out of the database before deleting itself. <br />
<br />
'''Remember to "take a copy" FIRST!'''<br />
<br />
# Click the DropBox<br />
# Select "Delete" from the popup menu<br />
# The DropBox will give you a confirmation screen; if you really want to delete it, click the appropriate option<br />
# The DropBox will clear its contents out of the website, before deleting itself inworld<br />
<br />
=== Products Showing That No Longer Exist? ===<br />
----<br />
This issue is most often caused by simply using "Edit > Delete" on an existing DropBox, '''OR''' a DropBox is accidentally returned to your lost & found folder. <br />
<br />
Here's the way to fix this: <br />
<br />
:# Log in to the CasperVend website<br />
:# Go to the '''[https://caspervend.casperdns.com/dropboxes.php DropBoxes page]'''<br />
:# You will see a list of all the DropBoxes the system thinks are still rezzed inworld. <br />
:# Click the '''"contents"''' link next to each dropbox and look through the contents<br />
:# When you find the incorrect dropbox, click '''"Manage"''' on the same line<br />
:# You will be taken to another page<br />
:# To delete that dropbox, select '''"Delete Unit"'''<br />
:# You will get a confirmation popup - click "ok"<br />
:# The system will process, and then reload the main DropBoxes page<br />
<br />
=== Accidentally Returned/Picked Up ===<br />
----<br />
Simply re-rez the DropBox. Your vendors will resume normal delivery operations without needing to touch anything on the website.<br />
<br />
= '''<span style="color:#00528c">The "DropBox Cloud"</span>''' =<br />
<br />
All DropBox(es) you have rezzed anywhere on the grid contribute to the "global product cloud" of your products. This is why it doesn't matter where you're dropboxes are, as long as they are rezzed inworld. <br />
<br />
The website will deliver '''one''' copy of the configured item, from '''the first available''' DropBox that has that product, AND responds in a timely manner. Due to general grid crappiness, sometimes a sim/region doesn't respond as well as it should - and having duplicates on different sims/regions means that the website has the opportunity to use other dropboxes for the delivery of that item instead of completely failing. <br />
<br />
So yes, multiple / duplicate / backup DropBox(es) are not only totally ok, they are actually encouraged!<br />
<br />
== '''<span style="color:#00528c">Setting Up Duplicate DropBoxes</span>''' ==<br />
You may think "backup sets", but it's really "duplicate sets" - the system does not seek out one set as a primary, the dropboxes send the product from (1) the first one to respond to the deliver command, that (2) has the product. If that's on your home sim, then that's where it comes from. If the first one to respond is one of your duplicated locations, then that's where it gets sent from. <br />
<br />
If you like, and you have multiple locations for your DropBoxes, you can work with ONE set as a "master set" of DropBoxes. Then, when you are done adding things in a particular session, simply do the following steps: <br />
<br />
# Right-click, then "Take a copy" of your existing DropBox(es)<br />
# Go to another sim/region where you have long-term rez rights. (If you're Premium and have a free parcel allowance, this would also be an ideal location. Please note that dropboxes are not allowed on Linden Homes, and please always check the covenant of the land you're using.) <br />
# Rez out the DropBox(es)<br />
# Wait for the DropBox(es) to talk to the website. <br />
# All set! Remember to leave the DropBox(es) rezzed at all times. <br />
<br />
You may organize your DropBoxes however you'd like, and you can rez however many you'd like (up to the maxmium prim/impact limits of the parcel, of course). <br />
<br />
=== Updating Duplicate DropBox(es) ===<br />
----<br />
If you want the products in all of your DropBox(es) to stay updated compared to each other, you will, unfortunately, need to do that manually. <br />
<br />
You can "designate" one set of DropBox(es) as your "master set" - this is NOT a scripted setting, and NOT something you do on the website, but in this case simply refers to the set that you update FIRST - whether you have it on your build platform (and set up an orb to keep random people from dropping in) or hanging out in your store is up to you. <br />
<br />
There are two ways of doing this: <br />
<br />
==== Adding Individual New Products ====<br />
----<br />
<br />
:# Go to each DropBox location<br />
:# Add the new product(s) to each pertinent DropBox<br />
<br />
If replacing old products, rather than just adding new: <br />
<br />
:# Go to each DropBox location<br />
:# Delete the old copy of the product you are replacing<br />
:# Replace with the new product<br />
<br />
Go around to all dropbox locations and add the new products to the pertinent DropBox(es) via Right-Click > Edit > Contents tab<br />
<br />
==== Replacing Older DropBox(es) ====<br />
---- <br />
<br />
:# Right-click > "Take a copy" of each dropbox that has been updated with new or replacement products <br />
:# Go to each additional DropBox location<br />
:# Delete the old copy rezzed out <br />
:# Replace with the new copy you just picked up <br />
:# Rez an upgradebee <br />
:# Wait for it to boot<br />
:# Click > select "Check All" <br />
:# Wait for it to run<br />
:# When it completes, simply delete the Bee<br />
<br />
You may see more numbers of objects it is checking than what you have/had rezzed out - this is normal, as a "check" will check ANYONE's, not just yours. It '''cannot''' do anything to anyone else's objects (and thus nobody else's upgrade bee can do anything to yours) - it just "pings" every CasperVend vendor or DropBox it knows WAS rezzed on the sim to see if it's still there.<br />
<br />
==== Last One Updated, First One Contacted ====<br />
----<br />
<br />
Usually, the last DropBox that gets updated with a new product is the one that the system tries to contact first.<br />
<br />
=== NOT On The Same Region ===<br />
----<br />
Having boxes containing the same item, on the '''same region''' is generally pointless. The goal behind having duplicate locations is to have reliability in case of sim/region-to-outside-world communication issues. Having all duplicate sets on the same sim/region means that they will all be affected when the sim/region goes out to lunch or runs out of URL's.<br />
<br />
=== On Different Regions ===<br />
----<br />
Having one or more duplicate DropBox(es) (DropBoxes containing the same items) on another region is '''absolutely recommended'''.<br />
<br />
Partly this is so that you have DropBoxes that work even when the simulator/region is down (especially if you have affiliate vendors out on the grid, or multiple locations) but also because simulators/regions occasionally "go dark" and refuse to talk to the outside world. The sim/region will still be up, inworld, and accessible to avatars even in this state, but because it's not talking to the outside world, DropBoxes on these affected sims/regions will be unable to deliver product to customers.<br />
<br />
Having one or more backup sets on other sims/regions reduces the chance that YOUR products won't deliver when customers make a purchase. These backup locations can be friend's homes, etc. There are also [[DropBox_Hosting|services on the grid]] that will allow you to rent a few prims just for DropBox purposes.<br />
<br />
= '''<span style="color:#00528c">DropBox Page on Website</span>''' =<br />
Your DropBoxes are now listed on the website, on the [https://wiki.casperdns.com/index.php/CasperVend_2/DropBoxes DropBoxes page]!<br />
<br />
The list is "colour coded" according to how long it's been since the site last contacted the dropbox. It does '''NOT''' mean that it's broken - deliveries will still happen. If you're concerned that it's shown with a colour background other than white, you may click the dropbox inworld and select "reset" - that'll make it contact the website and turn it white. It is '''NOT''' required that you do that - not being contacted doesn't mean it's not working. <br />
<br />
== The Columns ==<br />
:'''Last Seen:''' This is how long it's been since the website last talked to the dropbox. <br />
:'''Version:''' This is the script-reported version of the dropbox. An easy way to tell when you need to [[Current_Versions | check your versions]]. <br />
:'''Location:''' This is the listing of the sim, with a SLURL to the exact location where the DropBox is inworld. <br />
:'''Actions:''' You can "Manage" or view the "Contents" of the dropbox from this column. "Manage" gives you a page where you can ping, update, or delete the dropbox. "Contents" just shows you what's in it.<br />
<br />
== Colour Coding ==<br />
Yellow is for not being contacted for a short time. Pink is for not being contacted for a longer time. <br />
<br />
The variations in yellow and pink do not represent any specific timeframe, they alternate lighter and darker to make it easier for your eyes to follow a specific line.<br />
<br />
= '''<span style="color:#00528c">FAQ / Troubleshooting</span>''' =<br />
<br />
: '''Q. Why'd my vendors suddenly stop delivering notecards / demos / products?'''<br />
:: '''A.''' Things cannot be delivered if the system cannot find the dropbox, and/or cannot find the product items it's been told to send. Therefore, the first points to check are: <br />
::: * Is the item IN the dropbox? <br />
::: * Is the site pointing to the correct item(s)<br />
::: * Have you recently change name on the product / notecard / demo, without updating the website? <br />
::: * Has the sim/region "gone dark"? (If so, the only solution is restart the sim and/or have backup copies on at least one other sim/region.) <br />
::: * How many items are in your dropbox? (Remember if there are too many things in the dropbox, the SL servers seem to make stuff "go missing" - which would also prevent delivery of items.) <br />
::: * Also compare YOUR transaction log with the information in the '''[[CasperVend_2/Deliveries | Transactions & Deliveries]]''' page.<br />
<br />
: '''Q. My customers aren't getting the product after purchase, and the redelivery terminal keeps giving them a "Failed: Couldn't find delivery box for item on SLIFE. This merchant may no longer be using CasperVend." message, when it is, and I am.'''<br />
:: '''A1.''' Reset the DropBox(es). Use the touch menu first - if that doesn't work, then manually Edit > Reset scripts in selection to get them to actually reset. <br />
:: '''A2.''' If you have DropBox(es) on only one sim/region, then we strongly recommend having a backup set (see above) on at least one other sim/region location to reduce the risk of this happening again. <br />
<br />
: '''Q. I have a DropBox which shows as 'live' and as having __ items listed. However, when I open the drop box there are maybe half that amount of items showing inside the box.'''<br />
:: '''A.''' Casper Warden writes: "basically, if items have disappeared from the box, there's two possible reasons...<br />
::: '''1)''' they were no copy and were delivered<br />
::: '''2)''' your sim suffered an inventory failure or rollback<br />
:: in both circumstances the system isn't notified about the change :/ " <br />
:: When items that are no-copy to the merchant (such as breedable things) get sold, the # in the floaty text above the dropbox does NOT get updated.<br />
<br />
:'''Q. I got this message: "CasperVend DropBox: Items in the database seem to be out of sync! Re-uploading."'''<br />
:: '''A.''' Nothing to worry about - the system's self-check has determined that there is lag, either on the sim/region or in the grid itself. Once or twice per DropBox is normal (if you have multiple DropBoxes, you'll get several messages, but should just be one or two from each.) <br />
:: The only time to worry is when you get the message several times a day - that would indicate a sim/region communication problem, or that Casper is working on the backend servers. <br />
<br />
:'''Q. My last shop location is no more, I don't have access to it, and it keeps trying to send the OLD landmark. How can I fix this? '''<br />
:: '''A1.''' You'll need to edit *everywhere* you have it marked - usually this is in each and every single product listing - and set them up with the new landmark. <br />
:: '''A2.''' It is STRONGLY RECOMMENDED that you use a landmark name like '''"(your shop) - Main location"''' - rather than the default LL format that includes the sim/region name. Renaming your landmarks to something simple and WITHOUT the sim/region name means that when you have to move in the future, you can just outright swap the landmarks, without having to go through the hassle of updating every single product every time you change landmarks. <br />
<br />
:'''Q. I keep getting messages of "That item is no longer available or doesn't belong to you." when it is, and it does. '''<br />
:: '''A.''' Pick up and re-rez the DropBox, that should get rid of the spurious errors.</div>24607dde-d704-4db7-afa0-d9edc17c926chttps://wiki.casperdns.com/index.php?title=Official_Avatars&diff=15321Official Avatars2023-06-17T01:57:46Z<p>24607dde-d704-4db7-afa0-d9edc17c926c: /* Support avatars */</p>
<hr />
<div>There have been some cases of users creating false accounts with our brands, possibly with the intention of defrauding our customers.<br />
<br />
For security purposes, we have listed all of our official avatars below. '''Be very careful about subtle mis-spellings of these names'''.<br />
<br />
<span style="color:red">CasperTech Staff will '''never''' ask for your password, and will '''never''' offer you unsolicited gift cards</span><br />
<br />
== Support avatars ==<br />
<br />
'''ONLY THESE AVATARS ARE AUTHORISED CASPERTECH REPRESENTATIVES'''<br />
<br />
* Casper Warden<br />
* CasperHelp Resident<br />
* Donald Mole<br />
* Norsk Mole<br />
* Norsk Himmel<br />
* Sphynx Soleil<br />
* FreyasFashions Resident<br />
* Jules Catlyn<br />
* Norsk Resident<br />
* Ciel0001 Resident<br />
* FreyasFinestJewels Resident<br />
* FreyasFinest Resident<br />
* FreyasBot Resident<br />
* CasperSupportSteve Resident<br />
* CasperSupportImmy Resident<br />
* CasperSupportKit Resident<br />
* CasperSupportDonald Resident<br />
<br />
== Other avatars ==<br />
<br />
These avatars exist and belong to us, but are not used for support purposes.<br />
<br />
* CasperVend Resident ('''NOT''' CasperVendor)<br />
* CasperVendCommission Resident<br />
* RezFree Resident<br />
* CasperTech Resident<br />
* CasperTechGridSurvey Resident<br />
* CasperTechDemo Resident<br />
* CasperDemo Resident<br />
* CasperLet Resident<br />
* CasperPanel Resident<br />
* CasperDNS Resident<br />
* CasperSafe Resident<br />
* PrimBay Engineer<br />
* PrimBay Mint<br />
* PrimBay Resident<br />
* GridStatusUpdate Resident<br />
* Group Resident<br />
* OrlandoVictimsFund Resident<br />
* ItWorksOnMyMachine Resident</div>24607dde-d704-4db7-afa0-d9edc17c926chttps://wiki.casperdns.com/index.php?title=Current_Versions&diff=15293Current Versions2023-03-25T13:59:08Z<p>24607dde-d704-4db7-afa0-d9edc17c926c: /* Vendor Products */</p>
<hr />
<div>{|align=right<br />
|__TOC__<br />
|}<br />
<br />
== '''<span style="color:#00528c">Current Versions</span>''' ==<br />
<br />
Here are the current versions of CasperTech products. <br />
<br />
If you need to upgrade, see the '''[[CasperVend_2/Updating | Upgrades page]]''' for instructions. Remember, '''upgrades are free!''' <br />
<br />
=== '''Rental Products''' ===<br />
----<br />
'''CURRENT VERSIONS '''<br />
:* CasperLet DEMO - v1.54<br />
:* CasperLet - 1.54<br />
:* Door & Sign Full Perm Samples - v1.14<br />
:* DropBox - v2.70<br />
:* HippoRent Migration Toolkit - v2.0<br />
:* Mapper - v1.13<br />
:* Prim Counter - v2.16r3<br />
:* Remote relay Boxes & Meters - v1.17<br />
:* Web Kiosk & Vendor Expansion - v1.02<br />
<br />
'''VERSIONS NO LONGER SUPPORTED as of 1 April, 2023'''<br />
:* CasperLet units v1.53 and earlier<br />
:* DropBox v2.63 and earlier<br />
<br />
'''VERSIONS NO LONGER SUPPORTED as of 20th June, 2019'''<br />
:* DropBox - v2.50 and earlier<br />
<br />
'''VERSIONS NO LONGER SUPPORTED as of June 1st, 2017'''<br />
:* CasperLet 1.39 AND OLDER<br />
<br />
(v1.2x and older are '''no longer functional''' - the upgradebee will '''not''' work on versions this old, due to server changes, so they will need manual replacing to update. Simply redeliver to get the latest versions.)<br />
<br />
=== '''Vendor Products''' ===<br />
----<br />
:* CasperVend FatPack/Complete - 2.70<br />
:* DropBox - v2.70<br />
:* Gift Card Expansion - v3.02<br />
:* HoloVend Expansion - v2.23<br />
:* Lucky Chair Expansion - v2.10r2<br />
:* Midnight Madness Expansion - v2.10r2<br />
:* QuantityVend Expansion - v2.11r2<br />
:* TextureVend Expansion - v2.30<br />
:* Vendors (Premium) - 2.70<br />
:* Vendors (Free) - 2.70<br />
:* Redelivery Terminal v2.40 (November 2017)<br />
:* Event Vendor Replacement Script v2.12r2<br />
<br />
'''VERSIONS NO LONGER SUPPORTED as of 1 April, 2023'''<br />
:* CasperVend v2.12 and earlier<br />
:* HoloVend v2.22 and earlier<br />
:* DropBox v2.63 and earlier<br />
<br />
'''VERSIONS NO LONGER SUPPORTED as of 20th June, 2019'''<br />
:* DropBox - v2.50 and earlier<br />
<br />
=== '''Other Products''' ===<br />
----<br />
:* CasperTech CasperSafe - v1.48<br />
::* CasperSafe Enforcer - v1.46<br />
:* CasperTech Rez2 - v2.20 <br />
:* CasperTech SimpleSit - v1.92<br />
:* CasperTech Transporter - 1.40r2<br />
:* CasperUpdate - 1.5r2<br />
:* Let It Snow - v1.1r2<br />
:* Spinner - v1.11r2<br />
<br />
=== '''Retired - and Unsupported - Products''' ===<br />
----<br />
<br />
:* CasperTech Rez-Free - v1.58 <br />
:* CasperTech Rez-Free Premium - v1.58<br />
:* Titler Of Doom - v1.0 <br />
:* KKF Resizer v1.9r2<br />
:* EasyVend expansion (For migrating from E2V) - v2.02r2<br />
<br />
== '''<span style="color:#00528c">Changelogs</span>''' ==<br />
<br />
: '''[[CasperLet/ChangeLog | CasperLet Change Log]]'''<br />
: '''[[CasperSafe_Security_Orb/ChangeLog | CasperSafe ChangeLog]]'''<br />
: '''[[CasperVend_2/ChangeLog | CasperVend Change Log]] '''<br />
:: '''[[ChangeLog-HoloVend | HoloVend Changelog]]'''<br />
: '''[[CasperUpdate/ChangeLog | CasperUpdate Changelog]]'''<br />
: '''[[CasperVend_2/DropBoxes/ChangeLog | DropBox change Log]]'''<br />
: '''[[Rez2/ChangeLog | Rez2 Changelog]]'''<br />
: '''[[SimpleSit/ChangeLog | SimpleSit Changelog]]'''<br />
: '''[[Transporter/ChangeLog | Transporter Changelog]]'''</div>24607dde-d704-4db7-afa0-d9edc17c926chttps://wiki.casperdns.com/index.php?title=Current_Versions&diff=15012Current Versions2022-08-26T22:47:46Z<p>24607dde-d704-4db7-afa0-d9edc17c926c: /* Other Products */</p>
<hr />
<div>{|align=right<br />
|__TOC__<br />
|}<br />
<br />
== '''<span style="color:#00528c">Current Versions</span>''' ==<br />
<br />
Here are the current versions of CasperTech products. <br />
<br />
If you need to upgrade, see the '''[[CasperVend_2/Updating | Upgrades page]]''' for instructions. Remember, '''upgrades are free!''' <br />
<br />
=== '''Rental Products''' ===<br />
----<br />
'''CURRENT VERSIONS '''<br />
:* CasperLet DEMO - v1.52v6<br />
:* CasperLet - 1.53r3<br />
:* Door & Sign Full Perm Samples - v1.14<br />
:* DropBox - v2.70<br />
:* HippoRent Migration Toolkit - v2.0<br />
:* Mapper - v1.13<br />
:* Prim Counter - v2.16r3<br />
:* Slave Boxes & Meters - v1.17<br />
:* Web Kiosk & Vendor Expansion - v1.02<br />
<br />
'''VERSIONS NO LONGER SUPPORTED as of 20th June, 2019'''<br />
:* DropBox - v2.50 and earlier<br />
<br />
'''VERSIONS NO LONGER SUPPORTED as of June 1st, 2017'''<br />
:* CasperLet 1.39 AND OLDER<br />
<br />
(v1.2x and older are '''no longer functional''' - the upgradebee will '''not''' work on versions this old, due to server changes, so they will need manual replacing to update. Simply redeliver to get the latest versions.)<br />
<br />
=== '''Vendor Products''' ===<br />
----<br />
:* CasperVend FatPack/Complete - 2.70<br />
:* DropBox - v2.70<br />
:* Gatcha Expansion - v2.11r3<br />
:* Gift Card Expansion - v3.02<br />
:* HoloVend Expansion - v2.23<br />
:* Lucky Chair Expansion - v2.10r2<br />
:* Midnight Madness Expansion - v2.10r2<br />
:* QuantityVend Expansion - v2.11r2<br />
:* TextureVend Expansion - v2.30<br />
:* Vendors (Premium) - 2.70<br />
:* Vendors (Free) - 2.70<br />
:* Redelivery Terminal v2.40 (November 2017)<br />
:* Event Vendor Replacement Script v2.12r2<br />
:* EasyVend (Migrating from E2V) - v2.02r2<br />
<br />
'''VERSIONS NO LONGER SUPPORTED as of 20th June, 2019'''<br />
:* DropBox - v2.50 and earlier<br />
<br />
=== '''Other Products''' ===<br />
----<br />
:* CasperTech CasperSafe - v1.48<br />
::* CasperSafe Enforcer - v1.46<br />
:* CasperTech Rez2 - v2.20 <br />
:* CasperTech SimpleSit - v1.92<br />
:* CasperTech Transporter - 1.40r2<br />
:* CasperUpdate - 1.5r2<br />
:* Let It Snow - v1.1r2<br />
:* Spinner - v1.11r2<br />
<br />
=== '''Retired - and Unsupported - Products''' ===<br />
----<br />
<br />
:* CasperTech Rez-Free - v1.58 <br />
:* CasperTech Rez-Free Premium - v1.58<br />
:* Titler Of Doom - v1.0 <br />
:* KKF Resizer v1.9r2<br />
<br />
== '''<span style="color:#00528c">Changelogs</span>''' ==<br />
<br />
: '''[[CasperLet/ChangeLog | CasperLet Change Log]]'''<br />
: '''[[CasperSafe_Security_Orb/ChangeLog | CasperSafe ChangeLog]]'''<br />
: '''[[CasperVend_2/ChangeLog | CasperVend Change Log]] '''<br />
:: '''[[ChangeLog-HoloVend | HoloVend Changelog]]'''<br />
: '''[[CasperUpdate/ChangeLog | CasperUpdate Changelog]]'''<br />
: '''[[CasperVend_2/DropBoxes/ChangeLog | DropBox change Log]]'''<br />
: '''[[Rez2/ChangeLog | Rez2 Changelog]]'''<br />
: '''[[SimpleSit/ChangeLog | SimpleSit Changelog]]'''<br />
: '''[[Transporter/ChangeLog | Transporter Changelog]]'''</div>24607dde-d704-4db7-afa0-d9edc17c926chttps://wiki.casperdns.com/index.php?title=Current_Versions&diff=15011Current Versions2022-08-26T22:46:52Z<p>24607dde-d704-4db7-afa0-d9edc17c926c: /* Other Products */</p>
<hr />
<div>{|align=right<br />
|__TOC__<br />
|}<br />
<br />
== '''<span style="color:#00528c">Current Versions</span>''' ==<br />
<br />
Here are the current versions of CasperTech products. <br />
<br />
If you need to upgrade, see the '''[[CasperVend_2/Updating | Upgrades page]]''' for instructions. Remember, '''upgrades are free!''' <br />
<br />
=== '''Rental Products''' ===<br />
----<br />
'''CURRENT VERSIONS '''<br />
:* CasperLet DEMO - v1.52v6<br />
:* CasperLet - 1.53r3<br />
:* Door & Sign Full Perm Samples - v1.14<br />
:* DropBox - v2.70<br />
:* HippoRent Migration Toolkit - v2.0<br />
:* Mapper - v1.13<br />
:* Prim Counter - v2.16r3<br />
:* Slave Boxes & Meters - v1.17<br />
:* Web Kiosk & Vendor Expansion - v1.02<br />
<br />
'''VERSIONS NO LONGER SUPPORTED as of 20th June, 2019'''<br />
:* DropBox - v2.50 and earlier<br />
<br />
'''VERSIONS NO LONGER SUPPORTED as of June 1st, 2017'''<br />
:* CasperLet 1.39 AND OLDER<br />
<br />
(v1.2x and older are '''no longer functional''' - the upgradebee will '''not''' work on versions this old, due to server changes, so they will need manual replacing to update. Simply redeliver to get the latest versions.)<br />
<br />
=== '''Vendor Products''' ===<br />
----<br />
:* CasperVend FatPack/Complete - 2.70<br />
:* DropBox - v2.70<br />
:* Gatcha Expansion - v2.11r3<br />
:* Gift Card Expansion - v3.02<br />
:* HoloVend Expansion - v2.23<br />
:* Lucky Chair Expansion - v2.10r2<br />
:* Midnight Madness Expansion - v2.10r2<br />
:* QuantityVend Expansion - v2.11r2<br />
:* TextureVend Expansion - v2.30<br />
:* Vendors (Premium) - 2.70<br />
:* Vendors (Free) - 2.70<br />
:* Redelivery Terminal v2.40 (November 2017)<br />
:* Event Vendor Replacement Script v2.12r2<br />
:* EasyVend (Migrating from E2V) - v2.02r2<br />
<br />
'''VERSIONS NO LONGER SUPPORTED as of 20th June, 2019'''<br />
:* DropBox - v2.50 and earlier<br />
<br />
=== '''Other Products''' ===<br />
----<br />
:* CasperTech CasperSafe - v1.48<br />
::* CasperSafe Enforcer - v1.46<br />
:* CasperTech Rez2 - v2.20 <br />
:* CasperTech SimpleSit - v1.92<br />
:* CasperTech Transporter - v1.40<br />
:* CasperUpdate - 1.5r2<br />
:* Let It Snow - v1.1r2<br />
:* Spinner - v1.11r2<br />
<br />
=== '''Retired - and Unsupported - Products''' ===<br />
----<br />
<br />
:* CasperTech Rez-Free - v1.58 <br />
:* CasperTech Rez-Free Premium - v1.58<br />
:* Titler Of Doom - v1.0 <br />
:* KKF Resizer v1.9r2<br />
<br />
== '''<span style="color:#00528c">Changelogs</span>''' ==<br />
<br />
: '''[[CasperLet/ChangeLog | CasperLet Change Log]]'''<br />
: '''[[CasperSafe_Security_Orb/ChangeLog | CasperSafe ChangeLog]]'''<br />
: '''[[CasperVend_2/ChangeLog | CasperVend Change Log]] '''<br />
:: '''[[ChangeLog-HoloVend | HoloVend Changelog]]'''<br />
: '''[[CasperUpdate/ChangeLog | CasperUpdate Changelog]]'''<br />
: '''[[CasperVend_2/DropBoxes/ChangeLog | DropBox change Log]]'''<br />
: '''[[Rez2/ChangeLog | Rez2 Changelog]]'''<br />
: '''[[SimpleSit/ChangeLog | SimpleSit Changelog]]'''<br />
: '''[[Transporter/ChangeLog | Transporter Changelog]]'''</div>24607dde-d704-4db7-afa0-d9edc17c926chttps://wiki.casperdns.com/index.php?title=Current_Versions&diff=15010Current Versions2022-08-26T22:44:08Z<p>24607dde-d704-4db7-afa0-d9edc17c926c: /* Other Products */</p>
<hr />
<div>{|align=right<br />
|__TOC__<br />
|}<br />
<br />
== '''<span style="color:#00528c">Current Versions</span>''' ==<br />
<br />
Here are the current versions of CasperTech products. <br />
<br />
If you need to upgrade, see the '''[[CasperVend_2/Updating | Upgrades page]]''' for instructions. Remember, '''upgrades are free!''' <br />
<br />
=== '''Rental Products''' ===<br />
----<br />
'''CURRENT VERSIONS '''<br />
:* CasperLet DEMO - v1.52v6<br />
:* CasperLet - 1.53r3<br />
:* Door & Sign Full Perm Samples - v1.14<br />
:* DropBox - v2.70<br />
:* HippoRent Migration Toolkit - v2.0<br />
:* Mapper - v1.13<br />
:* Prim Counter - v2.16r3<br />
:* Slave Boxes & Meters - v1.17<br />
:* Web Kiosk & Vendor Expansion - v1.02<br />
<br />
'''VERSIONS NO LONGER SUPPORTED as of 20th June, 2019'''<br />
:* DropBox - v2.50 and earlier<br />
<br />
'''VERSIONS NO LONGER SUPPORTED as of June 1st, 2017'''<br />
:* CasperLet 1.39 AND OLDER<br />
<br />
(v1.2x and older are '''no longer functional''' - the upgradebee will '''not''' work on versions this old, due to server changes, so they will need manual replacing to update. Simply redeliver to get the latest versions.)<br />
<br />
=== '''Vendor Products''' ===<br />
----<br />
:* CasperVend FatPack/Complete - 2.70<br />
:* DropBox - v2.70<br />
:* Gatcha Expansion - v2.11r3<br />
:* Gift Card Expansion - v3.02<br />
:* HoloVend Expansion - v2.23<br />
:* Lucky Chair Expansion - v2.10r2<br />
:* Midnight Madness Expansion - v2.10r2<br />
:* QuantityVend Expansion - v2.11r2<br />
:* TextureVend Expansion - v2.30<br />
:* Vendors (Premium) - 2.70<br />
:* Vendors (Free) - 2.70<br />
:* Redelivery Terminal v2.40 (November 2017)<br />
:* Event Vendor Replacement Script v2.12r2<br />
:* EasyVend (Migrating from E2V) - v2.02r2<br />
<br />
'''VERSIONS NO LONGER SUPPORTED as of 20th June, 2019'''<br />
:* DropBox - v2.50 and earlier<br />
<br />
=== '''Other Products''' ===<br />
----<br />
:* CasperTech CasperSafe - v1.48<br />
::* CasperSafe Enforcer - v1.45<br />
:* CasperTech Rez2 - v2.20 <br />
:* CasperTech SimpleSit - v1.92<br />
:* CasperTech Transporter - v1.40<br />
:* CasperUpdate - 1.5r2<br />
:* Let It Snow - v1.1r2<br />
:* Spinner - v1.11r2<br />
<br />
=== '''Retired - and Unsupported - Products''' ===<br />
----<br />
<br />
:* CasperTech Rez-Free - v1.58 <br />
:* CasperTech Rez-Free Premium - v1.58<br />
:* Titler Of Doom - v1.0 <br />
:* KKF Resizer v1.9r2<br />
<br />
== '''<span style="color:#00528c">Changelogs</span>''' ==<br />
<br />
: '''[[CasperLet/ChangeLog | CasperLet Change Log]]'''<br />
: '''[[CasperSafe_Security_Orb/ChangeLog | CasperSafe ChangeLog]]'''<br />
: '''[[CasperVend_2/ChangeLog | CasperVend Change Log]] '''<br />
:: '''[[ChangeLog-HoloVend | HoloVend Changelog]]'''<br />
: '''[[CasperUpdate/ChangeLog | CasperUpdate Changelog]]'''<br />
: '''[[CasperVend_2/DropBoxes/ChangeLog | DropBox change Log]]'''<br />
: '''[[Rez2/ChangeLog | Rez2 Changelog]]'''<br />
: '''[[SimpleSit/ChangeLog | SimpleSit Changelog]]'''<br />
: '''[[Transporter/ChangeLog | Transporter Changelog]]'''</div>24607dde-d704-4db7-afa0-d9edc17c926chttps://wiki.casperdns.com/index.php?title=Current_Versions&diff=15009Current Versions2022-08-26T22:42:56Z<p>24607dde-d704-4db7-afa0-d9edc17c926c: /* Vendor Products */</p>
<hr />
<div>{|align=right<br />
|__TOC__<br />
|}<br />
<br />
== '''<span style="color:#00528c">Current Versions</span>''' ==<br />
<br />
Here are the current versions of CasperTech products. <br />
<br />
If you need to upgrade, see the '''[[CasperVend_2/Updating | Upgrades page]]''' for instructions. Remember, '''upgrades are free!''' <br />
<br />
=== '''Rental Products''' ===<br />
----<br />
'''CURRENT VERSIONS '''<br />
:* CasperLet DEMO - v1.52v6<br />
:* CasperLet - 1.53r3<br />
:* Door & Sign Full Perm Samples - v1.14<br />
:* DropBox - v2.70<br />
:* HippoRent Migration Toolkit - v2.0<br />
:* Mapper - v1.13<br />
:* Prim Counter - v2.16r3<br />
:* Slave Boxes & Meters - v1.17<br />
:* Web Kiosk & Vendor Expansion - v1.02<br />
<br />
'''VERSIONS NO LONGER SUPPORTED as of 20th June, 2019'''<br />
:* DropBox - v2.50 and earlier<br />
<br />
'''VERSIONS NO LONGER SUPPORTED as of June 1st, 2017'''<br />
:* CasperLet 1.39 AND OLDER<br />
<br />
(v1.2x and older are '''no longer functional''' - the upgradebee will '''not''' work on versions this old, due to server changes, so they will need manual replacing to update. Simply redeliver to get the latest versions.)<br />
<br />
=== '''Vendor Products''' ===<br />
----<br />
:* CasperVend FatPack/Complete - 2.70<br />
:* DropBox - v2.70<br />
:* Gatcha Expansion - v2.11r3<br />
:* Gift Card Expansion - v3.02<br />
:* HoloVend Expansion - v2.23<br />
:* Lucky Chair Expansion - v2.10r2<br />
:* Midnight Madness Expansion - v2.10r2<br />
:* QuantityVend Expansion - v2.11r2<br />
:* TextureVend Expansion - v2.30<br />
:* Vendors (Premium) - 2.70<br />
:* Vendors (Free) - 2.70<br />
:* Redelivery Terminal v2.40 (November 2017)<br />
:* Event Vendor Replacement Script v2.12r2<br />
:* EasyVend (Migrating from E2V) - v2.02r2<br />
<br />
'''VERSIONS NO LONGER SUPPORTED as of 20th June, 2019'''<br />
:* DropBox - v2.50 and earlier<br />
<br />
=== '''Other Products''' ===<br />
----<br />
:* CasperTech CasperSafe - v1.45r2<br />
::* CasperSafe Enforcer - v1.45<br />
:* CasperTech Rez2 - v2.20 <br />
:* CasperTech SimpleSit - v1.92<br />
:* CasperTech Transporter - v1.40<br />
:* CasperUpdate - 1.5r2<br />
:* Let It Snow - v1.1r2<br />
:* Spinner - v1.11r2<br />
<br />
=== '''Retired - and Unsupported - Products''' ===<br />
----<br />
<br />
:* CasperTech Rez-Free - v1.58 <br />
:* CasperTech Rez-Free Premium - v1.58<br />
:* Titler Of Doom - v1.0 <br />
:* KKF Resizer v1.9r2<br />
<br />
== '''<span style="color:#00528c">Changelogs</span>''' ==<br />
<br />
: '''[[CasperLet/ChangeLog | CasperLet Change Log]]'''<br />
: '''[[CasperSafe_Security_Orb/ChangeLog | CasperSafe ChangeLog]]'''<br />
: '''[[CasperVend_2/ChangeLog | CasperVend Change Log]] '''<br />
:: '''[[ChangeLog-HoloVend | HoloVend Changelog]]'''<br />
: '''[[CasperUpdate/ChangeLog | CasperUpdate Changelog]]'''<br />
: '''[[CasperVend_2/DropBoxes/ChangeLog | DropBox change Log]]'''<br />
: '''[[Rez2/ChangeLog | Rez2 Changelog]]'''<br />
: '''[[SimpleSit/ChangeLog | SimpleSit Changelog]]'''<br />
: '''[[Transporter/ChangeLog | Transporter Changelog]]'''</div>24607dde-d704-4db7-afa0-d9edc17c926chttps://wiki.casperdns.com/index.php?title=Current_Versions&diff=15008Current Versions2022-08-26T22:41:17Z<p>24607dde-d704-4db7-afa0-d9edc17c926c: /* Rental Products */</p>
<hr />
<div>{|align=right<br />
|__TOC__<br />
|}<br />
<br />
== '''<span style="color:#00528c">Current Versions</span>''' ==<br />
<br />
Here are the current versions of CasperTech products. <br />
<br />
If you need to upgrade, see the '''[[CasperVend_2/Updating | Upgrades page]]''' for instructions. Remember, '''upgrades are free!''' <br />
<br />
=== '''Rental Products''' ===<br />
----<br />
'''CURRENT VERSIONS '''<br />
:* CasperLet DEMO - v1.52v6<br />
:* CasperLet - 1.53r3<br />
:* Door & Sign Full Perm Samples - v1.14<br />
:* DropBox - v2.70<br />
:* HippoRent Migration Toolkit - v2.0<br />
:* Mapper - v1.13<br />
:* Prim Counter - v2.16r3<br />
:* Slave Boxes & Meters - v1.17<br />
:* Web Kiosk & Vendor Expansion - v1.02<br />
<br />
'''VERSIONS NO LONGER SUPPORTED as of 20th June, 2019'''<br />
:* DropBox - v2.50 and earlier<br />
<br />
'''VERSIONS NO LONGER SUPPORTED as of June 1st, 2017'''<br />
:* CasperLet 1.39 AND OLDER<br />
<br />
(v1.2x and older are '''no longer functional''' - the upgradebee will '''not''' work on versions this old, due to server changes, so they will need manual replacing to update. Simply redeliver to get the latest versions.)<br />
<br />
=== '''Vendor Products''' ===<br />
----<br />
:* CasperVend FatPack/Complete - 2.12r53<br />
:* DropBox - v2.63<br />
:* Gatcha Expansion - v2.11r3<br />
:* Gift Card Expansion - v3.02<br />
:* HoloVend Expansion - v2.23<br />
:* Lucky Chair Expansion - v2.10r2<br />
:* Midnight Madness Expansion - v2.10r2<br />
:* QuantityVend Expansion - v2.11r2<br />
:* TextureVend Expansion - v2.30<br />
:* Vendors (Premium) - 2.12r34<br />
:* Vendors (Free) - 2.12r29<br />
:* Redelivery Terminal v2.40 (November 2017)<br />
:* Event Vendor Replacement Script v2.12r2<br />
:* EasyVend (Migrating from E2V) - v2.02r2<br />
<br />
'''VERSIONS NO LONGER SUPPORTED as of 20th June, 2019'''<br />
:* DropBox - v2.50 and earlier<br />
<br />
=== '''Other Products''' ===<br />
----<br />
:* CasperTech CasperSafe - v1.45r2<br />
::* CasperSafe Enforcer - v1.45<br />
:* CasperTech Rez2 - v2.20 <br />
:* CasperTech SimpleSit - v1.92<br />
:* CasperTech Transporter - v1.40<br />
:* CasperUpdate - 1.5r2<br />
:* Let It Snow - v1.1r2<br />
:* Spinner - v1.11r2<br />
<br />
=== '''Retired - and Unsupported - Products''' ===<br />
----<br />
<br />
:* CasperTech Rez-Free - v1.58 <br />
:* CasperTech Rez-Free Premium - v1.58<br />
:* Titler Of Doom - v1.0 <br />
:* KKF Resizer v1.9r2<br />
<br />
== '''<span style="color:#00528c">Changelogs</span>''' ==<br />
<br />
: '''[[CasperLet/ChangeLog | CasperLet Change Log]]'''<br />
: '''[[CasperSafe_Security_Orb/ChangeLog | CasperSafe ChangeLog]]'''<br />
: '''[[CasperVend_2/ChangeLog | CasperVend Change Log]] '''<br />
:: '''[[ChangeLog-HoloVend | HoloVend Changelog]]'''<br />
: '''[[CasperUpdate/ChangeLog | CasperUpdate Changelog]]'''<br />
: '''[[CasperVend_2/DropBoxes/ChangeLog | DropBox change Log]]'''<br />
: '''[[Rez2/ChangeLog | Rez2 Changelog]]'''<br />
: '''[[SimpleSit/ChangeLog | SimpleSit Changelog]]'''<br />
: '''[[Transporter/ChangeLog | Transporter Changelog]]'''</div>24607dde-d704-4db7-afa0-d9edc17c926chttps://wiki.casperdns.com/index.php?title=CasperAuth&diff=14851CasperAuth2021-12-04T01:54:05Z<p>24607dde-d704-4db7-afa0-d9edc17c926c: </p>
<hr />
<div>{|align=right<br />
|__TOC__<br />
|}<br />
<br />
= '''<span style="color:#00528c">CasperAuth - the new login system</span>''' =<br />
<br />
Hello dear merchants!<br />
<br />
Some of you may have already noticed that we've activated a brand new (much simpler, and much more secure) login system on the CasperVend website.<br />
<br />
You may be asked to authenticate your avatar and choose a new password the next time you sign in.<br />
<br />
This is the first step in an effort to unify all our accounts systems into one. The new system also recognises avatar name changes instantly.<br />
<br />
If you encounter any trouble, please let us know!<br />
<br />
== '''<span style="color:#00528c">Existing Listings Are Still There!</span>''' ==<br />
You will '''NOT''' have to recreate listings - they will all still be there, ready for use, as they were before the new CasperAuth login system went into place.<br />
<br />
== '''<span style="color:#00528c">Supported Browsers</span>''' ==<br />
:* Chrome 52 (2016-07-20), and forward<br />
:* Firefox 52 (2017-03-07), and forward<br />
:* Safari 11 (2017-09-19), and forward<br />
:* Microsoft Edge 79 (2020-01-15), and forward<br />
:* Opera 39 (2016-08-02), and forward<br />
:* Yandex 17.4 (2017-05-30), and forward<br />
<br />
If the browser you want to inquire about is not listed here, it is not supported. <br />
<br />
That means the viewer-internal browser is not supported either.<br />
<br />
= '''<span style="color:#00528c">CasperVend Procedures</span>''' =<br />
<br />
== '''<span style="color:#00528c">Initial login via CasperAuth</span>''' ==<br />
<br />
You WILL need to be logged in to Second Life in order to do this. <br />
<br />
:# Go to the '''[https://caspervend.casperdns.com/ CasperVend website]''', you will arrive at a blue login screen<br />
:# Enter the avatar name that you originally created the CasperVend account under, and click "Continue"<br />
:# Click "Send Code Now"<br />
:# You will be sent a message INWORLD (from a bot, so it will be an actual IM) with a temporary password<br />
:# Double-click OR highlight-drag > CTL + C to copy the password into your paste buffer<br />
:# Paste it into the confirmation box on the website <br />
:# You will then be prompted to choose a NEW password (Need a '''[https://www.grc.com/passwords.htm password generator]'''?)<br />
:# Next, you will be prompted to link your avatar to your CasperVend account - click the GREEN authorise button<br />
:# Once you do that, the system will process things, and then forward you to your EXISTING CasperVend account<br />
<br />
=== '''Didn't get the inworld message?''' ===<br />
----<br />
<br />
If you didn't get the inworld message, check two things: <br />
<br />
: 1) Make sure you don't have "CasperHelp Resident" blocked<br />
: 2) Check your Privacy (or IMs & Logs, depending on viewer) preferences, make sure you allow IM's from ANYONE not just friends/groups<br />
<br />
== '''<span style="color:#00528c">CasperVend - Normal Logins, same name</span>''' ==<br />
<br />
:# Enter your avatar name, and click Continue<br />
:# Enter your password, click continue<br />
:# You will arrive at your expected CasperVend overview page<br />
<br />
== '''<span style="color:#00528c">CasperVend - Login, after changing account name</span>''' ==<br />
You should be able to log in immediately with the new name. <br />
<br />
=== Troubleshooting ===<br />
----<br />
If you try to sign in to the same account too many times, it will use Google's Recapcha to make sure you're not a bot. This is normal. <br />
<br />
If you are logging in several times to test something, and all of a sudden it stops responding, you likely have google and the recaptcha website blocked via either an adblocker or a javascript blocker. Just unblock them, reload and try again.<br />
<br />
== '''<span style="color:#00528c">Resetting Your CasperVend Password</span>''' ==<br />
<br />
<li>Rez out a vendor and click the CasperVend logo area - this is your "admin" button. If your vendor doesn't have a CasperVend logo, click the object (or the main display panel, if there is one) and choose "Admin" from the popup menu.</li><br />
<br />
<li>This will give you a popup menu with a site link, as well as the link in local chat history. </li><br />
:: ''If you do '''not''' see this, you will need to unmute yourself. Look in your viewer's mute/block list. ''<br />
<br />
<li>Take that link to the website. </li><br />
<br />
<li>You will be presented with a login prompt AND a "I've forgotten my password" link.</li> <br />
:: ''You will NOT see the "forgotten my password" link '''unless''' you use the link from one of your vendors or DropBox(es). This inworld authentication ensures that nobody can reset your password by simply visiting the website and entering your account name.''<br />
<br />
<li>Check the box for "I've forgotten by password"</li><br />
<li>Clear anything that exists in the "Password" field</li><br />
<li>Click "login". The website will add some text to the effect of "A link has been sent to you via instant message inworld. Please click it to verify this request." </li><br />
<br />
<li>Open your chat history inworld - you'll have a "Hello! Please click this link to reset your password" message with a link. </li><br />
<br />
<li>Click that link. You'll be taken back to the CasperVend website for the password reset page. Type in your new password in both boxes, and click "save password". </li><br />
<br />
<li>Once you do that, you'll be logged in to the website. All done!</li><br />
</ol><br />
<br />
== '''<span style="color:#00528c">Creating Your CasperDNS.com Account</span>''' ==<br />
{{Warning|IMPORTANT: For your own security, please do not use the same password that you use in any other vending systems, or in Second Life. Doing so runs the risk of multiple points of malicious compromise if someone manages to figure out your password.}}<br />
<br />
If you have trouble coming up with a secure password on your own, you can use the '''[https://www.grc.com/passwords.htm Gibson Research High Security Password Generator]'''. If you need a "password keeper" utility on windows, you can try '''[http://passwordsafe.sourceforge.net/ Password Safe]'''<br />
<br />
== '''<span style="color:#00528c">CasperLet Procedures</span>''' ==<br />
(Not implemented yet)</div>24607dde-d704-4db7-afa0-d9edc17c926chttps://wiki.casperdns.com/index.php?title=CasperVend_2/Profiles_and_groups&diff=14850CasperVend 2/Profiles and groups2021-11-27T18:29:58Z<p>24607dde-d704-4db7-afa0-d9edc17c926c: /* Setting Discounts on Profiles */</p>
<hr />
<div><!-- Keywords: range, ranges --><br />
{|align=right<br />
|__TOC__<br />
|}<br />
[[File:German_flag.gif]] [[CasperVend 2/Profiles and groups/DE | Schaue hier in Deutsch!]] <br />
= '''<span style="color:#00528c">Introduction</span>''' =<br />
Profiles specify which products show in a vendor, and the default profile shows EVERYTHING (that you haven't excluded via the product options). So, in order to have only certain products showing in a multi-panel vendor, you need to create a profile containing just those products that you want in that vendor. <br />
<br />
Profiles are applied on a per-vendor basis. You can have many vendors out, each with their own profile.<br />
<br />
Groups are a sub-category of profiles that allow you to group products together within a profile. For example you can set up individual products (such as a tuxedos, gowns shoes, and casual wear) and then group those products into groups (such as "mens formal", "womens formal", "footwear", etc.) and then put one or more groups into a profile (such as adding the "mens formal" and "womens formal" groups into a profile called "formal wear") and point a multi-panel vendor to that profile. <br />
<br />
Profiles can be applied directly to a vendor, but groups '''cannot'''. You must put a group within a profile, and then point the vendor to that profile.<br />
<br />
= '''<span style="color:#00528c">Profiles</span>''' =<br />
<br />
=== Creating a New Profile ===<br />
----<br />
<br />
:# Log in to the website<br />
:# Go to the "profiles" tab<br />
:# Click "Create New"<br />
:# You'll be taken to a screen with two white boxes <br />
:# Select a product from the left white box that you want to show in the vendor, and click the [-->] button. This will add the product to the profile. Repeat with each additional product you want in the profile. <br />
::: ''There is currently no way to select only some of the products. You can only move one, or move them all, nothing in between.''<br />
<br />
When you're done, click "Finish". Your profile is now ready for use!<br />
<br />
{| <br />
| [[File:CasperVend_Profiles.png|200px|thumb|right|Image of profile setup screen. Click to see larger version.]] <br />
|}<br />
<br />
=== New Profile From Vendor's Configuration Page ===<br />
----<br />
If you want to demo different products from different vendors, you need to put those products into a profile for the HoloVend. This can be done via the Caspervend website, the same way you'd put a multi-item vendor into a profile. <br />
<br />
# Click the CasperVend log on the face of the HoloVend.<br />
# You'll be sent a URL in a popup box, and in local chat.<br />
# Use that link to go to the website and log in.<br />
# If you have never used CasperVend before, '''[[CasperVend_2/Password_Reset#Creating_Your_CasperVend_Account | create your account]]''' now.<br />
# If you have '''forgotten''' your password, use the '''[[CasperVend_2/Password_Reset#Resetting_Your_CasperVend_Password | reset instructions.]]'''<br />
# Once you are logged in, you will reach the vendor configuration page.<br />
# Click '''"New Profile"''' next to the "Action" line: <br /> [[file:Vendor-action-newprofile.png|||"New Profile location on vendor config page]]<br />
# On the next screen, give the profile a distinctive name, then click "Next".<br />
# You will arrive at the profile creation page.<br />
# See the '''[[CasperVend_2/Profiles_and_groups | profiles page]]''' for details of how to select products.<br />
# When you are done selecting products for the profile, click "Finish". <br />
# Your vendor will now update to show the products you've selected.<br />
<br />
=== Editing an Existing Profile ===<br />
----<br />
When you want to edit an existing profile, any vendors which are currently set to that profile will be updated to show the current selection of products automatically when you are done. To edit an existing profile, use the following steps: <br />
<br />
:# Access the vendor configuration page, by clicking the (C)asperVend logo in the bottom left hand corner of the vendor.<br />
:# Switch to the "Profiles" tab on the left hand side.<br />
:# Find the profile you wish to edit, and click [Edit] next to it. You'll be taken to a page with two white boxes. <br />
:# Select a product from the left white box that you want to show in the vendor, and click the [-->] button. This will add the product to the profile. Repeat with each additional product you want in the profile. <br />
:: ''There is currently no way to select only several of the products. You can only move one, or move them all, nothing in between.''<br />
:# When you're done, click "Finish". <br />
<br />
=== Using an Existing Profile On Multi-Product Vendors ===<br />
----<br />
For scrolling, multi-product vendors, you need to create a full profile. If you only select a single product on a multi-item vendor, you'll see the same product across all the vendor panels. <br />
<br />
If you have already created a profile, you can assign it to more vendors. This can be convenient because it means if you change the profile in future, all vendors which are set to that profile will also be updated.<br />
<br />
:# Access the vendor configuration page, by clicking the (C)asperVend logo in the bottom left hand corner of the vendor.<br />
:# Look for the configuration option "Profile", and click [Change] next to it.<br />
:# Simply select the profile you want to set to the vendor, then click [Save]. <br />
:# The vendor will then be updated to use your new profile within a couple minutes!<br />
<br />
=== Using a profile on multiple vendors ===<br />
----<br />
The best way to get a profile to "stick" to a vendor - whether one or multiple - is to tell the vendor(s) what profile to use during setup. While you can change the profile later, it will NOT change copies in your SL inventory, object inventory, or marketplace inventory - they can only "hear" the profile change command from the system while they are rezzed inworld.<br />
<br />
As long as the vendor was rezzed inworld to "hear" the profile change command, any future copies of THAT vendor (or vendors) will also use the same new profile. If you have copies of that vendor(s) still in inventory with the old profile, you must delete them and pick up new copies of the vendor(s) with the new profile.<br />
<br />
= '''<span style="color:#00528c">Excluding From Default Profile</span>''' =<br />
As you gain more experience as a merchant, you may find you don't want to have all the products in the "default" (everything) profile. Here's how you can remove existing products from that profile: <br />
<br />
:# Log in to your CasperVend<br />
:# Go to the '''[https://caspervend.casperdns.com/productsNew.php Products]''' tab<br />
:# Show the products you want to exclude from the default<br />
:# Tick the selector boxes on the left of each product (or you can use the "all" button at the top)<br />
:# Scroll down to the bulk updates block <br />
:# Tick the box for "set product options" <br />
:# Tick the option box for "Exclude this product from the default profile"<br />
:# Scroll down and click "Update Selected" <br />
:# Wait for it to process<br />
<br />
All set! <br />
<br />
{| <br />
| [[File:Exclude_from_default.jpg|300px|thumb|left|Arrows pointing to the appropriate options]]<br />
|}<br />
<br />
= '''<span style="color:#00528c">Groups</span>''' =<br />
When you go to create a profile, you can add in individual products, or one (or more) groups, or both. Then a vendor can be pointed to that profile. Groups '''cannot''' be added to a vendor - only single products or a profile. <br />
<br />
=== Creating a New Group ===<br />
----<br />
Because group names will appear in the product list along with your other products, you should give your groups a consistent beginning to the name to sort them to one findable place in the list - you could start the group name with ''"Group - "''' for example. <br />
<br />
:# Log in to the CasperVend website<br />
:# Click "Groups" <br />
:# Click "Create New Group"<br />
:# Enter a name for the new product group in the text box and then click "Create"<br />
:# You will be presented with a pair of white boxes, the left one showing your existing products, and the right one starting off empty. <br />
:# Select the products you want to have in this group. Click to select one product, then click the --> right arrow to move it to the box on the right side. You can only move one at a time, or all of them at once. <br />
:# When you are done, click finish. Your group is complete! <br />
<br />
There is currently no way to select only some of the products. You can only move one, or move them all, nothing in between.<br />
<br />
=== Adding a Group to a Profile ===<br />
----<br />
When you want to add a group to an existing profile, any vendors which are currently set to that profile will be updated to show the current selection of products - including the grouped products - automatically when you are done. To edit an existing profile, use the following steps: <br />
<br />
:# Access the vendor configuration page, by clicking the (C)asperVend logo in the bottom left hand corner of the vendor.<br />
:# Switch to the "Profiles" tab on the left hand side.<br />
:# Find the profile you wish to edit, and click [Edit] next to it. You'll be taken to a page with two white boxes. <br />
:# Select a product from the left white box that you want to show in the vendor, and click the [-->] button. This will add the product to the profile. Repeat with each additional product you want in the profile. <br />
:# When you're done, click "Finish". <br />
<br />
There is currently no way to select only some of the products. You can only move one, or move them all, nothing in between.<br />
<br />
= '''<span style="color:#00528c">Setting Discounts on Profiles</span>''' =<br />
Discounts on profiles will give all customers (not just group members) a discount off the regular price of everything in that profile. (The "regular price" is the price you set in the product listing.) <br />
<br />
'''''Discounts on profiles only apply to the vendor(s) set to SHOW that profile. It is not a profile of products, regardless of what vendor they are shown on.'''''<br />
<br />
:# Log in to the website<br />
:# Go to the "profiles" tab<br />
:# Find the profile you want to offer a discount on, and click "Edit" next to it<br />
:# You'll be taken to the profile screen with the two white boxes<br />
:# Above those two white boxes are three checkboxes<br />
:# Tick the box for "Discount all items in this profile by ____%" and fill in the % discount<br />
:# Click finish<br />
:# All set!<br />
<br />
= '''<span style="color:#00528c">Setting Price Overrides on Profiles</span>''' =<br />
Price overrides on profiles will override the product pricing of '''everything''' in '''that''' profile, regardless of any sale going on at that time, making them all cost the amount you put in the little box. Be absolutely certain you want to do this, especially if you have an expensive build in the profile that you don't want sold at a really cheap price. <br />
<br />
Price overrides on profiles only apply to the vendor(s) set to SHOW that profile. It is not a profile of products, regardless of what vendor they are shown on.<br />
<br />
:# Log in to the website<br />
:# Go to the "profiles" tab<br />
:# Find the profile you want to offer a discount on, and click "Edit" next to it<br />
:# You'll be taken to the profile screen with the two white boxes<br />
:# Above those two white boxes are three checkboxes<br />
:# Tick the box for "Override the price of all products in this profile to L$___" and fill in the override price <br />
:# Click finish<br />
:# All set!<br />
<br />
= '''<span style="color:#00528c">A Note On Naming Groups & Profiles</span>''' =<br />
<br />
Group and Profile names MUST be alphanumeric. Symbols will end the Group or Profile name<br />
<br />
= '''<span style="color:#00528c">Not What You Were Looking For?</span>''' =<br />
If this doesn't answer the "How do I...?" question you have, perhaps you need the page on '''[[CasperVend_2/Customers_Page | setting a storewide sale]]''' or the one for '''[[CasperVend_2/Vendor_Discounts | vendor discounts]]''' instead? <br />
<br />
&nbsp;</div>24607dde-d704-4db7-afa0-d9edc17c926chttps://wiki.casperdns.com/index.php?title=CasperVend_2/Customers_Page&diff=14849CasperVend 2/Customers Page2021-11-27T18:17:55Z<p>24607dde-d704-4db7-afa0-d9edc17c926c: /* How do I exclude specific vendors from the sale */</p>
<hr />
<div>[[File:German_flag.gif]] [[CasperVend_2/Customers_Page/DE | Schaue hier in Deutsch!]]<br />
{|align=right<br />
|__TOC__<br />
|}<br />
<br />
== '''<span style="color:#00528c">Setting All Vendors for a Grid-wide / Store-wide Sale</span>''' ==<br />
This will set '''all of your vendors, everywhere on the grid''', to this discount. <br />
<br />
<ol><br />
<li> Log in to Caspervend.com</li><br />
<li> Click "customers" tab</li><br />
<li> Up at the top, in the "customer rewards" box, click the "Add New" link</li><br />
<li> Fill in the minimum spend (for a store/grid-wide sale, you'll want "0") </li><br />
<li> Fill in the discount level. </li><br />
<li> Click "Add" - you won't get a message, but the page will refresh and show you the new discount level.</li><br />
<li> All set! When you're done with the sale, just click the "x" in front of the discount line to remove the discount.</li> <br />
</ol><br />
<br />
Remember that only '''ONE''' discount will apply for any given transaction - the largest discount that is currently available. <br />
<br />
=== So if I want to set all vendors for a 50% sale to everyone.... ===<br />
----<br />
<ol><br />
<li> Log in to Caspervend.com</li><br />
<li> Click "customers" tab</li><br />
<li> Up at the top, in the "customer rewards" box, click the "Add New" link</li><br />
<li> Set the minimum spend L$ box to: '''0'''</li><br />
<li> Set the % box to: '''50''' </li><br />
<li> Click "Add" - you won't get a message, but the page will refresh and show you the new discount level.</li><br />
<li> All set! </li><br />
</ol><br />
<br />
=== How do I remove the sale when I'm done? ===<br />
----<br />
For the above example of a 50% sale, you should see on your customers page (in addition to any other discounts you may have set): <br />
<br />
'''Minimum Spend % Discount'''<br />
[X] L$0 50%<br />
<br />
<ol> <br />
<li>Click the '''X''' at the start of the line with the discount you no longer want.</li><br />
<li>Page will refresh and remove that line. All set! </li><br />
</ol><br />
<br />
=== How do I exclude specific vendors from the sale? ===<br />
<br />
To exclude specific vendors from this sale method, for example at an event, you must set on the vendor(s) in question the option:-<br />
<br />
"Don't allow any discounts to be awarded (except the group & general discounts specified above)."<br />
<br />
When making that change to the vendor(s) you must then '''RESET the vendor inworld''' when using the [[CasperVend_2/Event_Vendor_Script|Event Vendor Replacement script]]<br />
<br />
== '''<span style="color:#00528c">"Spend" on Marketplace versus "Spend" inworld</span>''' ==<br />
If you have set up the Marketplace ANS feed properly, customer purchases ON Marketplace will accumulate towards the "spend" total for any loyalty options you have set up. <br />
<br />
However, any customer rewards you have set up will '''ONLY''' apply to purchases on inworld vendors.<br />
<br />
== '''<span style="color:#00528c">About The Loyalty Program Options </span>''' ==<br />
[[File:Loyalty_Program.png|300px|thumb|right|Click to see larger image]]<br />
Numbered options in this section refer to the image at the right. <br />
<br />
=== 1) Customer Rewards Box ===<br />
----<br />
This is where you set up your spending/discount tier levels. Click "Add New" (bottom middle of that darker box) to add a new spending/discount tier, and the percentage discount the customer will get after reaching that level.<br />
<br />
By default, discounts set will be issued as cash refunds. This behavior may be modified with the following options, marked 2 through 5 on the image to the right.<br />
<br />
=== 2) Discount Vs. Store Credit Option ===<br />
----<br />
Ticking/checking this box turns the discount into store credit instead of cash back. <br />
<br />
=== 3) Refund on Purchase Option ===<br />
----<br />
Ticking/Checking this box controls whether store credit is automatically refunded, or if it's only spendable via clicking the vendor and then selecting "buy" off the popup menu. This option has no effect if the 'store credit' option is not used.<br />
<br />
=== 4) Don't Allow "Buy As Gift" With Credit Option ===<br />
----<br />
This prevents the customer from using their store credit to purchase an item as a gift for someone else. So if you hire people and pay them in store credit, they can only use the store credit for purchases going to themselves. <br />
<br />
=== 5) Display As Reward Points Option ===<br />
----<br />
This option does NOT affect the amount the customer gets in any applicable loyalty bonus - it simply changes how it is displayed. <br />
<br />
This will change the customer loyalty message to say something to the effect of:<br />
''You will receive reward points for purchases from this vendor.'' <br />
''Spend L$___ more with us to qualify for even more bonus reward points on future purchases!''<br />
with an additional part depending on their spending level: <br />
<br />
If they have '''not''' spent enough to reach a discount tier, the additional part of the message will be: <br />
''You won't currently receive any discount for purchases from this vendor.''<br />
<br />
If they '''have''' spent enough to reach a discount tier, the additional part of the message will be: <br />
''You have ___ remaining reward points. To use them, touch the vendor, choose 'Buy' and then select 'Reward Points'.''<br />
<br />
==== &nbsp; Handy Tip====<br />
----<br />
Setting a high ratio of points to lindens will make customers think they have more money.<br />
<br />
== '''<span style="color:#00528c">Setting General Customer Loyalty Discounts</span>''' ==<br />
This is for setting your general loyalty discounts. These discounts will give "cash back" to customers who've purchased products totaling over the minimum level(s) you specify using these instructions. <br />
<br />
<ol><br />
<li> Log in to Caspervend.com</li><br />
<li> Click "customers" tab</li><br />
<li> Up at the top, in the "customer rewards" box, click the "Add New" link</li><br />
<li> Fill in the minimum spend level. This is for how much you want your customers to have spent in your store before getting this discount. </li><br />
<li> Fill in the discount level. </li><br />
<li> Click "Add" - you won't get a message, but the page will refresh and show you the new discount level.</li><br />
<li> All set! </li><br />
</ol><br />
::'''NOTE:'''<br />
::* Loyalty '''discounts''' will refund automatically when they happen. They are not saved for later use. If you are looking for the loyalty CREDIT system, see the next section.<br />
<br />
== '''<span style="color:#00528c">Setting General Customer Loyalty Credit (Store Credit)</span>''' ==<br />
<ol><br />
<li> Log in to Caspervend.com</li><br />
<li> Click "Customers" tab</li><br />
<li> Under the "Customer Rewards" box is a checkbox for "Apply reward as store credit..."</li><br />
<li> Check that box</li><br />
<li> Then, up at the top, in the "customer rewards" box, click the "Add New" link</li><br />
<li> Fill your chosen spend levels. This is for how much you want your customers to have spent in your store before getting the credit percentage. </li><br />
<li> Click "save" </li><br />
<li> All set!</li><br />
</ol><br />
<br />
::'''NOTE:''' <br />
::* Store credit is NOT refunded UNTIL the customer buys something. <br />
::* Only an amount up to the value of the purchase is refunded. The rest remains "on the account" for future use.<br />
<br />
== '''<span style="color:#00528c">Setting Discounts For Specific Customers</span>''' ==<br />
This is used for when you want to give a special discount to a specific person, rather than to a group of people who've spent x-amount. <br />
<ol><br />
<li> Log in to Caspervend.com</li><br />
<li> Click "customers" tab</li><br />
<li> Find the customer's name in the list</li><br />
<li> On the "Discount" column, find the "set" button for that customer and click it</li><br />
<li> Fill in the percentage discount in the white box and click save</li><br />
<li> All set! </li><br />
</ol><br />
<br />
== '''<span style="color:#00528c">Giving (Individual) Customers a Credit Balance</span>''' ==<br />
This is used for when you want to give a credit balance to a specific customer. <br />
<ol><br />
<li> Log in to Caspervend.com</li><br />
<li> Click "customers" tab</li><br />
<li> Find the customer's name in the list</li><br />
<li> On the "Balance" column, find the "set" button for that customer and click it</li><br />
<li> Fill in the L$ amount in the white box and click save</li><br />
<li> All set! </li><br />
</ol><br />
<br />
== '''<span style="color:#00528c">How Customers Check Their Loyalty Program Levels</span>''' ==<br />
# Customer clicks any vendor<br />
# Customer chooses "discounts" from the popup menu<br />
# Customer will be presented with another popup that gives the following information: <br />
::* Total amount spent so far (or total points gained so far)<br />
::* Current cash-back discount level, if any<br />
::* How much they need to spend for the next loyalty tier<br />
::* What their loyalty level will be at the next tier, if set<br />
::* Existing credit balance they have, if any<br />
<br />
== '''<span style="color:#00528c">A Word on Price Overrides</span>''' ==<br />
<br />
If you have a price override set [[CasperVend_2/Vendor_Discounts#Setting_a_Price_Override_on_a_Vendor | on a vendor]] or [[CasperVend_2/Profiles_and_groups#Setting_Price_Overrides_on_Profiles | on a profile]], the price override '''WILL''' override the global discount as outlined on this page.<br />
<br />
== '''<span style="color:#00528c">FAQ / Troubleshooting</span>''' ==<br />
<br />
: '''Q. If you have two discounts (one set for all, and one set for a group) - does the larger one override the smaller, or do they both apply? '''<br />
:: '''A.''' The largest discount applies to the transaction, the other(s) do not.<br />
<br />
== '''<span style="color:#00528c">Not What You Were Looking For?</span>''' ==<br />
<br />
If this doesn't answer the "How do I...?" question you have, perhaps you need the page on [[CasperVend_2/Profiles_and_groups | profile discounts and overrides]] or the one for [[CasperVend_2/Vendor_Discounts | vendor discounts and overrides]] instead? <br />
<br />
&nbsp;</div>24607dde-d704-4db7-afa0-d9edc17c926chttps://wiki.casperdns.com/index.php?title=CasperVend_2/Customers_Page&diff=14848CasperVend 2/Customers Page2021-11-27T18:16:43Z<p>24607dde-d704-4db7-afa0-d9edc17c926c: /* How do I exclude specific vendors from the sale */</p>
<hr />
<div>[[File:German_flag.gif]] [[CasperVend_2/Customers_Page/DE | Schaue hier in Deutsch!]]<br />
{|align=right<br />
|__TOC__<br />
|}<br />
<br />
== '''<span style="color:#00528c">Setting All Vendors for a Grid-wide / Store-wide Sale</span>''' ==<br />
This will set '''all of your vendors, everywhere on the grid''', to this discount. <br />
<br />
<ol><br />
<li> Log in to Caspervend.com</li><br />
<li> Click "customers" tab</li><br />
<li> Up at the top, in the "customer rewards" box, click the "Add New" link</li><br />
<li> Fill in the minimum spend (for a store/grid-wide sale, you'll want "0") </li><br />
<li> Fill in the discount level. </li><br />
<li> Click "Add" - you won't get a message, but the page will refresh and show you the new discount level.</li><br />
<li> All set! When you're done with the sale, just click the "x" in front of the discount line to remove the discount.</li> <br />
</ol><br />
<br />
Remember that only '''ONE''' discount will apply for any given transaction - the largest discount that is currently available. <br />
<br />
=== So if I want to set all vendors for a 50% sale to everyone.... ===<br />
----<br />
<ol><br />
<li> Log in to Caspervend.com</li><br />
<li> Click "customers" tab</li><br />
<li> Up at the top, in the "customer rewards" box, click the "Add New" link</li><br />
<li> Set the minimum spend L$ box to: '''0'''</li><br />
<li> Set the % box to: '''50''' </li><br />
<li> Click "Add" - you won't get a message, but the page will refresh and show you the new discount level.</li><br />
<li> All set! </li><br />
</ol><br />
<br />
=== How do I remove the sale when I'm done? ===<br />
----<br />
For the above example of a 50% sale, you should see on your customers page (in addition to any other discounts you may have set): <br />
<br />
'''Minimum Spend % Discount'''<br />
[X] L$0 50%<br />
<br />
<ol> <br />
<li>Click the '''X''' at the start of the line with the discount you no longer want.</li><br />
<li>Page will refresh and remove that line. All set! </li><br />
</ol><br />
<br />
=== How do I exclude specific vendors from the sale ===<br />
<br />
To exclude specific vendors from this sale method, for example at an event, you must set on the vendor(s) in question the option:-<br />
<br />
"Don't allow any discounts to be awarded (except the group & general discounts specified above)."<br />
<br />
When making that change to the vendor(s) you must then '''RESET the vendor inworld''' when using the [[CasperVend_2/Event_Vendor_Script|Event Vendor Replacement script]]<br />
<br />
== '''<span style="color:#00528c">"Spend" on Marketplace versus "Spend" inworld</span>''' ==<br />
If you have set up the Marketplace ANS feed properly, customer purchases ON Marketplace will accumulate towards the "spend" total for any loyalty options you have set up. <br />
<br />
However, any customer rewards you have set up will '''ONLY''' apply to purchases on inworld vendors.<br />
<br />
== '''<span style="color:#00528c">About The Loyalty Program Options </span>''' ==<br />
[[File:Loyalty_Program.png|300px|thumb|right|Click to see larger image]]<br />
Numbered options in this section refer to the image at the right. <br />
<br />
=== 1) Customer Rewards Box ===<br />
----<br />
This is where you set up your spending/discount tier levels. Click "Add New" (bottom middle of that darker box) to add a new spending/discount tier, and the percentage discount the customer will get after reaching that level.<br />
<br />
By default, discounts set will be issued as cash refunds. This behavior may be modified with the following options, marked 2 through 5 on the image to the right.<br />
<br />
=== 2) Discount Vs. Store Credit Option ===<br />
----<br />
Ticking/checking this box turns the discount into store credit instead of cash back. <br />
<br />
=== 3) Refund on Purchase Option ===<br />
----<br />
Ticking/Checking this box controls whether store credit is automatically refunded, or if it's only spendable via clicking the vendor and then selecting "buy" off the popup menu. This option has no effect if the 'store credit' option is not used.<br />
<br />
=== 4) Don't Allow "Buy As Gift" With Credit Option ===<br />
----<br />
This prevents the customer from using their store credit to purchase an item as a gift for someone else. So if you hire people and pay them in store credit, they can only use the store credit for purchases going to themselves. <br />
<br />
=== 5) Display As Reward Points Option ===<br />
----<br />
This option does NOT affect the amount the customer gets in any applicable loyalty bonus - it simply changes how it is displayed. <br />
<br />
This will change the customer loyalty message to say something to the effect of:<br />
''You will receive reward points for purchases from this vendor.'' <br />
''Spend L$___ more with us to qualify for even more bonus reward points on future purchases!''<br />
with an additional part depending on their spending level: <br />
<br />
If they have '''not''' spent enough to reach a discount tier, the additional part of the message will be: <br />
''You won't currently receive any discount for purchases from this vendor.''<br />
<br />
If they '''have''' spent enough to reach a discount tier, the additional part of the message will be: <br />
''You have ___ remaining reward points. To use them, touch the vendor, choose 'Buy' and then select 'Reward Points'.''<br />
<br />
==== &nbsp; Handy Tip====<br />
----<br />
Setting a high ratio of points to lindens will make customers think they have more money.<br />
<br />
== '''<span style="color:#00528c">Setting General Customer Loyalty Discounts</span>''' ==<br />
This is for setting your general loyalty discounts. These discounts will give "cash back" to customers who've purchased products totaling over the minimum level(s) you specify using these instructions. <br />
<br />
<ol><br />
<li> Log in to Caspervend.com</li><br />
<li> Click "customers" tab</li><br />
<li> Up at the top, in the "customer rewards" box, click the "Add New" link</li><br />
<li> Fill in the minimum spend level. This is for how much you want your customers to have spent in your store before getting this discount. </li><br />
<li> Fill in the discount level. </li><br />
<li> Click "Add" - you won't get a message, but the page will refresh and show you the new discount level.</li><br />
<li> All set! </li><br />
</ol><br />
::'''NOTE:'''<br />
::* Loyalty '''discounts''' will refund automatically when they happen. They are not saved for later use. If you are looking for the loyalty CREDIT system, see the next section.<br />
<br />
== '''<span style="color:#00528c">Setting General Customer Loyalty Credit (Store Credit)</span>''' ==<br />
<ol><br />
<li> Log in to Caspervend.com</li><br />
<li> Click "Customers" tab</li><br />
<li> Under the "Customer Rewards" box is a checkbox for "Apply reward as store credit..."</li><br />
<li> Check that box</li><br />
<li> Then, up at the top, in the "customer rewards" box, click the "Add New" link</li><br />
<li> Fill your chosen spend levels. This is for how much you want your customers to have spent in your store before getting the credit percentage. </li><br />
<li> Click "save" </li><br />
<li> All set!</li><br />
</ol><br />
<br />
::'''NOTE:''' <br />
::* Store credit is NOT refunded UNTIL the customer buys something. <br />
::* Only an amount up to the value of the purchase is refunded. The rest remains "on the account" for future use.<br />
<br />
== '''<span style="color:#00528c">Setting Discounts For Specific Customers</span>''' ==<br />
This is used for when you want to give a special discount to a specific person, rather than to a group of people who've spent x-amount. <br />
<ol><br />
<li> Log in to Caspervend.com</li><br />
<li> Click "customers" tab</li><br />
<li> Find the customer's name in the list</li><br />
<li> On the "Discount" column, find the "set" button for that customer and click it</li><br />
<li> Fill in the percentage discount in the white box and click save</li><br />
<li> All set! </li><br />
</ol><br />
<br />
== '''<span style="color:#00528c">Giving (Individual) Customers a Credit Balance</span>''' ==<br />
This is used for when you want to give a credit balance to a specific customer. <br />
<ol><br />
<li> Log in to Caspervend.com</li><br />
<li> Click "customers" tab</li><br />
<li> Find the customer's name in the list</li><br />
<li> On the "Balance" column, find the "set" button for that customer and click it</li><br />
<li> Fill in the L$ amount in the white box and click save</li><br />
<li> All set! </li><br />
</ol><br />
<br />
== '''<span style="color:#00528c">How Customers Check Their Loyalty Program Levels</span>''' ==<br />
# Customer clicks any vendor<br />
# Customer chooses "discounts" from the popup menu<br />
# Customer will be presented with another popup that gives the following information: <br />
::* Total amount spent so far (or total points gained so far)<br />
::* Current cash-back discount level, if any<br />
::* How much they need to spend for the next loyalty tier<br />
::* What their loyalty level will be at the next tier, if set<br />
::* Existing credit balance they have, if any<br />
<br />
== '''<span style="color:#00528c">A Word on Price Overrides</span>''' ==<br />
<br />
If you have a price override set [[CasperVend_2/Vendor_Discounts#Setting_a_Price_Override_on_a_Vendor | on a vendor]] or [[CasperVend_2/Profiles_and_groups#Setting_Price_Overrides_on_Profiles | on a profile]], the price override '''WILL''' override the global discount as outlined on this page.<br />
<br />
== '''<span style="color:#00528c">FAQ / Troubleshooting</span>''' ==<br />
<br />
: '''Q. If you have two discounts (one set for all, and one set for a group) - does the larger one override the smaller, or do they both apply? '''<br />
:: '''A.''' The largest discount applies to the transaction, the other(s) do not.<br />
<br />
== '''<span style="color:#00528c">Not What You Were Looking For?</span>''' ==<br />
<br />
If this doesn't answer the "How do I...?" question you have, perhaps you need the page on [[CasperVend_2/Profiles_and_groups | profile discounts and overrides]] or the one for [[CasperVend_2/Vendor_Discounts | vendor discounts and overrides]] instead? <br />
<br />
&nbsp;</div>24607dde-d704-4db7-afa0-d9edc17c926chttps://wiki.casperdns.com/index.php?title=CasperVend_2/Customers_Page&diff=14847CasperVend 2/Customers Page2021-11-27T18:15:18Z<p>24607dde-d704-4db7-afa0-d9edc17c926c: /* How do I exclude specific vendors from the sale */</p>
<hr />
<div>[[File:German_flag.gif]] [[CasperVend_2/Customers_Page/DE | Schaue hier in Deutsch!]]<br />
{|align=right<br />
|__TOC__<br />
|}<br />
<br />
== '''<span style="color:#00528c">Setting All Vendors for a Grid-wide / Store-wide Sale</span>''' ==<br />
This will set '''all of your vendors, everywhere on the grid''', to this discount. <br />
<br />
<ol><br />
<li> Log in to Caspervend.com</li><br />
<li> Click "customers" tab</li><br />
<li> Up at the top, in the "customer rewards" box, click the "Add New" link</li><br />
<li> Fill in the minimum spend (for a store/grid-wide sale, you'll want "0") </li><br />
<li> Fill in the discount level. </li><br />
<li> Click "Add" - you won't get a message, but the page will refresh and show you the new discount level.</li><br />
<li> All set! When you're done with the sale, just click the "x" in front of the discount line to remove the discount.</li> <br />
</ol><br />
<br />
Remember that only '''ONE''' discount will apply for any given transaction - the largest discount that is currently available. <br />
<br />
=== So if I want to set all vendors for a 50% sale to everyone.... ===<br />
----<br />
<ol><br />
<li> Log in to Caspervend.com</li><br />
<li> Click "customers" tab</li><br />
<li> Up at the top, in the "customer rewards" box, click the "Add New" link</li><br />
<li> Set the minimum spend L$ box to: '''0'''</li><br />
<li> Set the % box to: '''50''' </li><br />
<li> Click "Add" - you won't get a message, but the page will refresh and show you the new discount level.</li><br />
<li> All set! </li><br />
</ol><br />
<br />
=== How do I remove the sale when I'm done? ===<br />
----<br />
For the above example of a 50% sale, you should see on your customers page (in addition to any other discounts you may have set): <br />
<br />
'''Minimum Spend % Discount'''<br />
[X] L$0 50%<br />
<br />
<ol> <br />
<li>Click the '''X''' at the start of the line with the discount you no longer want.</li><br />
<li>Page will refresh and remove that line. All set! </li><br />
</ol><br />
<br />
=== How do I exclude specific vendors from the sale ===<br />
<br />
To exclude specific vendors from this sale method, for example at an event, you must set on the vendor(s) in question the option:-<br />
<br />
"Don't allow any discounts to be awarded (except the group & general discounts specified above)."<br />
<br />
When making that change to the vendor(s) you must then '''RESET the vendor inworld''' when using the [[https://wiki.casperdns.com/index.php/CasperVend_2/Event_Vendor_Script| Event Vendor Replacement script]]<br />
<br />
== '''<span style="color:#00528c">"Spend" on Marketplace versus "Spend" inworld</span>''' ==<br />
If you have set up the Marketplace ANS feed properly, customer purchases ON Marketplace will accumulate towards the "spend" total for any loyalty options you have set up. <br />
<br />
However, any customer rewards you have set up will '''ONLY''' apply to purchases on inworld vendors.<br />
<br />
== '''<span style="color:#00528c">About The Loyalty Program Options </span>''' ==<br />
[[File:Loyalty_Program.png|300px|thumb|right|Click to see larger image]]<br />
Numbered options in this section refer to the image at the right. <br />
<br />
=== 1) Customer Rewards Box ===<br />
----<br />
This is where you set up your spending/discount tier levels. Click "Add New" (bottom middle of that darker box) to add a new spending/discount tier, and the percentage discount the customer will get after reaching that level.<br />
<br />
By default, discounts set will be issued as cash refunds. This behavior may be modified with the following options, marked 2 through 5 on the image to the right.<br />
<br />
=== 2) Discount Vs. Store Credit Option ===<br />
----<br />
Ticking/checking this box turns the discount into store credit instead of cash back. <br />
<br />
=== 3) Refund on Purchase Option ===<br />
----<br />
Ticking/Checking this box controls whether store credit is automatically refunded, or if it's only spendable via clicking the vendor and then selecting "buy" off the popup menu. This option has no effect if the 'store credit' option is not used.<br />
<br />
=== 4) Don't Allow "Buy As Gift" With Credit Option ===<br />
----<br />
This prevents the customer from using their store credit to purchase an item as a gift for someone else. So if you hire people and pay them in store credit, they can only use the store credit for purchases going to themselves. <br />
<br />
=== 5) Display As Reward Points Option ===<br />
----<br />
This option does NOT affect the amount the customer gets in any applicable loyalty bonus - it simply changes how it is displayed. <br />
<br />
This will change the customer loyalty message to say something to the effect of:<br />
''You will receive reward points for purchases from this vendor.'' <br />
''Spend L$___ more with us to qualify for even more bonus reward points on future purchases!''<br />
with an additional part depending on their spending level: <br />
<br />
If they have '''not''' spent enough to reach a discount tier, the additional part of the message will be: <br />
''You won't currently receive any discount for purchases from this vendor.''<br />
<br />
If they '''have''' spent enough to reach a discount tier, the additional part of the message will be: <br />
''You have ___ remaining reward points. To use them, touch the vendor, choose 'Buy' and then select 'Reward Points'.''<br />
<br />
==== &nbsp; Handy Tip====<br />
----<br />
Setting a high ratio of points to lindens will make customers think they have more money.<br />
<br />
== '''<span style="color:#00528c">Setting General Customer Loyalty Discounts</span>''' ==<br />
This is for setting your general loyalty discounts. These discounts will give "cash back" to customers who've purchased products totaling over the minimum level(s) you specify using these instructions. <br />
<br />
<ol><br />
<li> Log in to Caspervend.com</li><br />
<li> Click "customers" tab</li><br />
<li> Up at the top, in the "customer rewards" box, click the "Add New" link</li><br />
<li> Fill in the minimum spend level. This is for how much you want your customers to have spent in your store before getting this discount. </li><br />
<li> Fill in the discount level. </li><br />
<li> Click "Add" - you won't get a message, but the page will refresh and show you the new discount level.</li><br />
<li> All set! </li><br />
</ol><br />
::'''NOTE:'''<br />
::* Loyalty '''discounts''' will refund automatically when they happen. They are not saved for later use. If you are looking for the loyalty CREDIT system, see the next section.<br />
<br />
== '''<span style="color:#00528c">Setting General Customer Loyalty Credit (Store Credit)</span>''' ==<br />
<ol><br />
<li> Log in to Caspervend.com</li><br />
<li> Click "Customers" tab</li><br />
<li> Under the "Customer Rewards" box is a checkbox for "Apply reward as store credit..."</li><br />
<li> Check that box</li><br />
<li> Then, up at the top, in the "customer rewards" box, click the "Add New" link</li><br />
<li> Fill your chosen spend levels. This is for how much you want your customers to have spent in your store before getting the credit percentage. </li><br />
<li> Click "save" </li><br />
<li> All set!</li><br />
</ol><br />
<br />
::'''NOTE:''' <br />
::* Store credit is NOT refunded UNTIL the customer buys something. <br />
::* Only an amount up to the value of the purchase is refunded. The rest remains "on the account" for future use.<br />
<br />
== '''<span style="color:#00528c">Setting Discounts For Specific Customers</span>''' ==<br />
This is used for when you want to give a special discount to a specific person, rather than to a group of people who've spent x-amount. <br />
<ol><br />
<li> Log in to Caspervend.com</li><br />
<li> Click "customers" tab</li><br />
<li> Find the customer's name in the list</li><br />
<li> On the "Discount" column, find the "set" button for that customer and click it</li><br />
<li> Fill in the percentage discount in the white box and click save</li><br />
<li> All set! </li><br />
</ol><br />
<br />
== '''<span style="color:#00528c">Giving (Individual) Customers a Credit Balance</span>''' ==<br />
This is used for when you want to give a credit balance to a specific customer. <br />
<ol><br />
<li> Log in to Caspervend.com</li><br />
<li> Click "customers" tab</li><br />
<li> Find the customer's name in the list</li><br />
<li> On the "Balance" column, find the "set" button for that customer and click it</li><br />
<li> Fill in the L$ amount in the white box and click save</li><br />
<li> All set! </li><br />
</ol><br />
<br />
== '''<span style="color:#00528c">How Customers Check Their Loyalty Program Levels</span>''' ==<br />
# Customer clicks any vendor<br />
# Customer chooses "discounts" from the popup menu<br />
# Customer will be presented with another popup that gives the following information: <br />
::* Total amount spent so far (or total points gained so far)<br />
::* Current cash-back discount level, if any<br />
::* How much they need to spend for the next loyalty tier<br />
::* What their loyalty level will be at the next tier, if set<br />
::* Existing credit balance they have, if any<br />
<br />
== '''<span style="color:#00528c">A Word on Price Overrides</span>''' ==<br />
<br />
If you have a price override set [[CasperVend_2/Vendor_Discounts#Setting_a_Price_Override_on_a_Vendor | on a vendor]] or [[CasperVend_2/Profiles_and_groups#Setting_Price_Overrides_on_Profiles | on a profile]], the price override '''WILL''' override the global discount as outlined on this page.<br />
<br />
== '''<span style="color:#00528c">FAQ / Troubleshooting</span>''' ==<br />
<br />
: '''Q. If you have two discounts (one set for all, and one set for a group) - does the larger one override the smaller, or do they both apply? '''<br />
:: '''A.''' The largest discount applies to the transaction, the other(s) do not.<br />
<br />
== '''<span style="color:#00528c">Not What You Were Looking For?</span>''' ==<br />
<br />
If this doesn't answer the "How do I...?" question you have, perhaps you need the page on [[CasperVend_2/Profiles_and_groups | profile discounts and overrides]] or the one for [[CasperVend_2/Vendor_Discounts | vendor discounts and overrides]] instead? <br />
<br />
&nbsp;</div>24607dde-d704-4db7-afa0-d9edc17c926chttps://wiki.casperdns.com/index.php?title=CasperVend_2/Customers_Page&diff=14846CasperVend 2/Customers Page2021-11-27T18:11:24Z<p>24607dde-d704-4db7-afa0-d9edc17c926c: </p>
<hr />
<div>[[File:German_flag.gif]] [[CasperVend_2/Customers_Page/DE | Schaue hier in Deutsch!]]<br />
{|align=right<br />
|__TOC__<br />
|}<br />
<br />
== '''<span style="color:#00528c">Setting All Vendors for a Grid-wide / Store-wide Sale</span>''' ==<br />
This will set '''all of your vendors, everywhere on the grid''', to this discount. <br />
<br />
<ol><br />
<li> Log in to Caspervend.com</li><br />
<li> Click "customers" tab</li><br />
<li> Up at the top, in the "customer rewards" box, click the "Add New" link</li><br />
<li> Fill in the minimum spend (for a store/grid-wide sale, you'll want "0") </li><br />
<li> Fill in the discount level. </li><br />
<li> Click "Add" - you won't get a message, but the page will refresh and show you the new discount level.</li><br />
<li> All set! When you're done with the sale, just click the "x" in front of the discount line to remove the discount.</li> <br />
</ol><br />
<br />
Remember that only '''ONE''' discount will apply for any given transaction - the largest discount that is currently available. <br />
<br />
=== So if I want to set all vendors for a 50% sale to everyone.... ===<br />
----<br />
<ol><br />
<li> Log in to Caspervend.com</li><br />
<li> Click "customers" tab</li><br />
<li> Up at the top, in the "customer rewards" box, click the "Add New" link</li><br />
<li> Set the minimum spend L$ box to: '''0'''</li><br />
<li> Set the % box to: '''50''' </li><br />
<li> Click "Add" - you won't get a message, but the page will refresh and show you the new discount level.</li><br />
<li> All set! </li><br />
</ol><br />
<br />
=== How do I remove the sale when I'm done? ===<br />
----<br />
For the above example of a 50% sale, you should see on your customers page (in addition to any other discounts you may have set): <br />
<br />
'''Minimum Spend % Discount'''<br />
[X] L$0 50%<br />
<br />
<ol> <br />
<li>Click the '''X''' at the start of the line with the discount you no longer want.</li><br />
<li>Page will refresh and remove that line. All set! </li><br />
</ol><br />
<br />
=== How do I exclude specific vendors from the sale ===<br />
<br />
To exclude specific vendors from this sale method, for example at an event, you must set on the vendor(s) in question the option:-<br />
<br />
"Don't allow any discounts to be awarded (except the group & general discounts specified above)."<br />
<br />
When making that change to the vendor(s) you must then '''RESET the vendor inworld''' when using the Event Vendor Replacement script<br />
<br />
<br />
== '''<span style="color:#00528c">"Spend" on Marketplace versus "Spend" inworld</span>''' ==<br />
If you have set up the Marketplace ANS feed properly, customer purchases ON Marketplace will accumulate towards the "spend" total for any loyalty options you have set up. <br />
<br />
However, any customer rewards you have set up will '''ONLY''' apply to purchases on inworld vendors.<br />
<br />
== '''<span style="color:#00528c">About The Loyalty Program Options </span>''' ==<br />
[[File:Loyalty_Program.png|300px|thumb|right|Click to see larger image]]<br />
Numbered options in this section refer to the image at the right. <br />
<br />
=== 1) Customer Rewards Box ===<br />
----<br />
This is where you set up your spending/discount tier levels. Click "Add New" (bottom middle of that darker box) to add a new spending/discount tier, and the percentage discount the customer will get after reaching that level.<br />
<br />
By default, discounts set will be issued as cash refunds. This behavior may be modified with the following options, marked 2 through 5 on the image to the right.<br />
<br />
=== 2) Discount Vs. Store Credit Option ===<br />
----<br />
Ticking/checking this box turns the discount into store credit instead of cash back. <br />
<br />
=== 3) Refund on Purchase Option ===<br />
----<br />
Ticking/Checking this box controls whether store credit is automatically refunded, or if it's only spendable via clicking the vendor and then selecting "buy" off the popup menu. This option has no effect if the 'store credit' option is not used.<br />
<br />
=== 4) Don't Allow "Buy As Gift" With Credit Option ===<br />
----<br />
This prevents the customer from using their store credit to purchase an item as a gift for someone else. So if you hire people and pay them in store credit, they can only use the store credit for purchases going to themselves. <br />
<br />
=== 5) Display As Reward Points Option ===<br />
----<br />
This option does NOT affect the amount the customer gets in any applicable loyalty bonus - it simply changes how it is displayed. <br />
<br />
This will change the customer loyalty message to say something to the effect of:<br />
''You will receive reward points for purchases from this vendor.'' <br />
''Spend L$___ more with us to qualify for even more bonus reward points on future purchases!''<br />
with an additional part depending on their spending level: <br />
<br />
If they have '''not''' spent enough to reach a discount tier, the additional part of the message will be: <br />
''You won't currently receive any discount for purchases from this vendor.''<br />
<br />
If they '''have''' spent enough to reach a discount tier, the additional part of the message will be: <br />
''You have ___ remaining reward points. To use them, touch the vendor, choose 'Buy' and then select 'Reward Points'.''<br />
<br />
==== &nbsp; Handy Tip====<br />
----<br />
Setting a high ratio of points to lindens will make customers think they have more money.<br />
<br />
== '''<span style="color:#00528c">Setting General Customer Loyalty Discounts</span>''' ==<br />
This is for setting your general loyalty discounts. These discounts will give "cash back" to customers who've purchased products totaling over the minimum level(s) you specify using these instructions. <br />
<br />
<ol><br />
<li> Log in to Caspervend.com</li><br />
<li> Click "customers" tab</li><br />
<li> Up at the top, in the "customer rewards" box, click the "Add New" link</li><br />
<li> Fill in the minimum spend level. This is for how much you want your customers to have spent in your store before getting this discount. </li><br />
<li> Fill in the discount level. </li><br />
<li> Click "Add" - you won't get a message, but the page will refresh and show you the new discount level.</li><br />
<li> All set! </li><br />
</ol><br />
::'''NOTE:'''<br />
::* Loyalty '''discounts''' will refund automatically when they happen. They are not saved for later use. If you are looking for the loyalty CREDIT system, see the next section.<br />
<br />
== '''<span style="color:#00528c">Setting General Customer Loyalty Credit (Store Credit)</span>''' ==<br />
<ol><br />
<li> Log in to Caspervend.com</li><br />
<li> Click "Customers" tab</li><br />
<li> Under the "Customer Rewards" box is a checkbox for "Apply reward as store credit..."</li><br />
<li> Check that box</li><br />
<li> Then, up at the top, in the "customer rewards" box, click the "Add New" link</li><br />
<li> Fill your chosen spend levels. This is for how much you want your customers to have spent in your store before getting the credit percentage. </li><br />
<li> Click "save" </li><br />
<li> All set!</li><br />
</ol><br />
<br />
::'''NOTE:''' <br />
::* Store credit is NOT refunded UNTIL the customer buys something. <br />
::* Only an amount up to the value of the purchase is refunded. The rest remains "on the account" for future use.<br />
<br />
== '''<span style="color:#00528c">Setting Discounts For Specific Customers</span>''' ==<br />
This is used for when you want to give a special discount to a specific person, rather than to a group of people who've spent x-amount. <br />
<ol><br />
<li> Log in to Caspervend.com</li><br />
<li> Click "customers" tab</li><br />
<li> Find the customer's name in the list</li><br />
<li> On the "Discount" column, find the "set" button for that customer and click it</li><br />
<li> Fill in the percentage discount in the white box and click save</li><br />
<li> All set! </li><br />
</ol><br />
<br />
== '''<span style="color:#00528c">Giving (Individual) Customers a Credit Balance</span>''' ==<br />
This is used for when you want to give a credit balance to a specific customer. <br />
<ol><br />
<li> Log in to Caspervend.com</li><br />
<li> Click "customers" tab</li><br />
<li> Find the customer's name in the list</li><br />
<li> On the "Balance" column, find the "set" button for that customer and click it</li><br />
<li> Fill in the L$ amount in the white box and click save</li><br />
<li> All set! </li><br />
</ol><br />
<br />
== '''<span style="color:#00528c">How Customers Check Their Loyalty Program Levels</span>''' ==<br />
# Customer clicks any vendor<br />
# Customer chooses "discounts" from the popup menu<br />
# Customer will be presented with another popup that gives the following information: <br />
::* Total amount spent so far (or total points gained so far)<br />
::* Current cash-back discount level, if any<br />
::* How much they need to spend for the next loyalty tier<br />
::* What their loyalty level will be at the next tier, if set<br />
::* Existing credit balance they have, if any<br />
<br />
== '''<span style="color:#00528c">A Word on Price Overrides</span>''' ==<br />
<br />
If you have a price override set [[CasperVend_2/Vendor_Discounts#Setting_a_Price_Override_on_a_Vendor | on a vendor]] or [[CasperVend_2/Profiles_and_groups#Setting_Price_Overrides_on_Profiles | on a profile]], the price override '''WILL''' override the global discount as outlined on this page.<br />
<br />
== '''<span style="color:#00528c">FAQ / Troubleshooting</span>''' ==<br />
<br />
: '''Q. If you have two discounts (one set for all, and one set for a group) - does the larger one override the smaller, or do they both apply? '''<br />
:: '''A.''' The largest discount applies to the transaction, the other(s) do not.<br />
<br />
== '''<span style="color:#00528c">Not What You Were Looking For?</span>''' ==<br />
<br />
If this doesn't answer the "How do I...?" question you have, perhaps you need the page on [[CasperVend_2/Profiles_and_groups | profile discounts and overrides]] or the one for [[CasperVend_2/Vendor_Discounts | vendor discounts and overrides]] instead? <br />
<br />
&nbsp;</div>24607dde-d704-4db7-afa0-d9edc17c926chttps://wiki.casperdns.com/index.php?title=CasperVend_2/DropBoxes&diff=14819CasperVend 2/DropBoxes2021-09-13T22:19:03Z<p>24607dde-d704-4db7-afa0-d9edc17c926c: /* Limits */</p>
<hr />
<div>{|align=right<br />
|__TOC__<br />
|}<br />
<br />
<!---- Keywords: product server ----> <br />
<br />
[[File:German_flag.gif]] [[CasperVend 2/DropBoxes/DE | Schaue hier in Deutsch!]]<br />
<br />
= '''<span style="color:#00528c">About the DropBox</span>''' =<br />
<br />
=== Current Version ===<br />
----<br />
Current version information may be '''[[Current_Versions | seen here]]'''. It's always a good idea to keep your dropbox(es) up to date, since version changes are quite often working around new bugs in sim communications that can cause failed deliveries.<br />
<br />
=== Limits ===<br />
----<br />
We recommend keeping the number of items in a dropbox below 200, the approximate number most people are comfortable with while waiting for the contents to load, with 400 being an upper limit in extreme cases. There have been issues reported with Second Life object inventories when people go substantially over these numbers.<br />
<br />
=== Moving / Returning DropBox ===<br />
----<br />
If your DropBox is accidentally returned to your inventory, simply rez it back out from your "Lost & Found" folder. No additional action needs to be taken once the DropBox is rezzed out once more; the site will pick up the contents automatically. <br />
<br />
If you need to move, simply follow these steps: <br />
:# Right-click DropBox<br />
:# Select "Take a copy" <br />
:# Click DropBox again<br />
:# Select "Delete" from popup menu<br />
:# Confirm delete (This will flush contents from website cache) <br />
:# Go to new location<br />
:# Rez copy of DropBox <br />
:# All set! <br />
<br />
=== Must Stay Rezzed ===<br />
----<br />
Your dropbox must be rezzed out - inworld - '''AT ALL TIMES''' or it cannot deliver your products, notecards, etc. to your customers.<br />
<br />
'''Remember:''' All Scripted delivery objects will not function if you do not rez them under the proper land group (when it is group land). DropBoxes are no exception. <br />
<br />
=== Placement ===<br />
----<br />
It doesn't matter where you put your DropBox. However, there are certain caveats you should be aware of:<br />
<br />
:# The land must let YOU run scripts - either enabled for all, or you are in the land group.<br />
:# You must have continual access, in order to add/remove products.<br />
<br />
=== Public or Private Land? ===<br />
----<br />
Other people cannot edit your dropboxes (unless you've given them "mod rights" on your stuff), so public locations are perfectly safe.<br />
<br />
However, please read the rental agreement / land covenant FOR that location so make sure dropboxes in general are allowed - because land managers/owners can still return objects, even if they can't do anything else to them. <br />
<br />
=== Renaming Your DropBoxes ===<br />
----<br />
By default, the "physical" name of your dropbox is something like:<br />
<br />
CasperVend DropBox v((version #))<br />
<br />
It's not only ok to rename your DropBox, it is '''strongly recommended''' - at least to include YOUR store name. The name of the DropBox your product comes from is seen in the delivery message that the customer receives - so be aware of that when renaming the box.<br />
<br />
Renaming is also recommended because if someone mutes "CasperVend DropBox v((version #))" from someone else, and YOUR DropBox name matches that, yours will get caught in that muting as well. <br />
<br />
=== Seeing your DropBoxes ===<br />
----<br />
<br />
DropBoxes are now listed on the CasperVend website, on the '''[https://caspervend.casperdns.com/dropboxes.php DropBoxes]''' page. <br />
<br />
This page shows you: <br />
:# Name of the DropBox <br />
:# Version number<br />
:# Sim location (clickable link to location inworld) <br />
:# Last contacted<br />
:# # of items in the DropBox<br />
:# Option to '''manage''' that specific DropBox and see the '''contents" <br />
<br />
At the top of that page you can also list "10, 20, 50, 100 or All" of your DropBoxes at once. The default is 10 per page.<br />
<br />
=== DropBox Address Message ===<br />
----<br />
<br />
The DropBox that responds to a request to deliver an object will send its physical location with the delivery message. <br />
<br />
This is a grid limitation by the Lindens and cannot be changed via scripting. This was instituted several years ago by the Lindens as an anti-griefing measure, to make it easier to report the location of a griefing object, and it applies to ALL objects across the grid that send messages. <br />
<br />
While you don't have to keep your DropBox in your store or rental headquarters, keep in mind that the occasional customer may unexpectedly drop in where the DropBox is located if they click the address link. You can set up a security orb (or banlines) if you wish on a '''private''' location, or just relocate the box(es) to a location where you don't mind customers occasionally dropping in.<br />
<br />
= '''<span style="color:#00528c">Using Your DropBox</span>''' =<br />
''The DropBox only '''seems''' no-modify in your inventory. This is due to the DropBox script being no-modify. Once you rez it out, the prim WILL be modifiable and allow you to add contents.''<br />
<br />
== '''<span style="color:#00528c">Organising Your Items</span>''' ==<br />
How you organize your DropBox contents is ENTIRELY up to you.<br />
<br />
:*It doesn't matter which items are in which box<br />
:*It doesn't matter where your box is in Second Life (caveats: see '''[[#DropBox_placement|Placement]]''').<br />
:* '''[[CasperVend_2/DropBoxes#Setting_Up_Duplicate_DropBoxes | Duplicate sets]]''' are always recommended<br />
<br />
There is one organisational limitation that you must always remember:<br />
<br />
:*Be careful to give '''all items''' a unique name. For example, '''don't''' name a texture the same as one of your items - If you have two different items with the exact same name (in different DropBoxes), the system '''may assume''' it is a second copy of the first item and may deliver ''either one''!<br />
<br />
And yes, capitalisation and typos count!<br />
<br />
== '''<span style="color:#00528c">CasperLet Specific Information</span>''' ==<br />
<br />
The bulk of this page is written with CasperVend and CasperUpdate in mind. <br />
<br />
While the DropBox within the CasperLet crate is the same thing (with the same script) that's in the CasperVend and CasperUpdate crate, CasperLet itself only uses notecards and landmarks. <br />
<br />
If you '''only''' use CasperLet, understand that you will only be loading notecards and landmarks in your DropBox, despite references in most of this page to "products". <br />
<br />
== '''<span style="color:#00528c">Loading Your Dropbox</span>''' ==<br />
<br />
:#Rez the DropBox out<br />
:#Right-click on the DropBox<br />
:#Select "Edit", then go to "Contents" tab. <br />
:#Drag your packaged items, textures and any notecards you have ready into the dropbox.<br />
:#Make sure that your notecards / landmarks / textures / packaged items are all named differently - if you name a texture the same as your object, for example, the vendor system will deliver - or redeliver - '''one''' of '''either''' of them. This means that if your customer pays for a packaged product, and your texture has the exact same name as your packaged product, the customer may get the texture '''instead''' of the packaged product.<br />
<br />
=== Cannot Share DropBoxes ===<br />
----<br />
'''The DropBox only recognizes the owner that unpacked it from the shipping crate.''' <br />
<br />
You cannot "share with group", it will not load other people's products. You cannot deed to a group, because the DropBox is no transfer. (And even if you could, it wouldn't work - the group would then be the owner, and the group isn't the one that purchased the copy of CasperVend that the DropBox came from...)<br />
<br />
=== No Folders ===<br />
----<br />
DropBoxes '''CANNOT''' accept a folder AS a folder - it will always assume the contents of the folders are separate products. If you have multiple items for one product, they need to go in '''THEIR OWN''' box / bag / shipping crate / package before going in the dropbox. Do not put an object named NYAN into the DropBox or strange things may happen...<br />
<br />
=== Your DropBox won't let you add things? ===<br />
----<br />
The grid is known for occasionally not letting things work as well as they should. Here are some troubleshooting points if it doesn't seem like the DropBox is letting you put stuff in it: <br />
<br />
: # Did you "lock" the dropbox (maybe to prevent accidently deleting it)? <br />
: # Has everything in the dropbox fully loaded in the edit / contents window? (SL usually won't let you add things until everything is loaded)<br />
: # Is SL not letting you do other things either? (may need to relog...)<br />
: # Try CTL + dragging the item from your inventory to the DropBox.<br />
: # Is it round or a box? If it's round, you've grabbed the "UpgradeBee DROPBOXES ONLY" by mistake, and that will ALWAYS be no-mod. Search for '''"CasperTech DropBox"''' instead.<br />
<br />
=== "How do I connect the DropBox to...." ===<br />
----<br />
<br />
You don't. All the dropboxes work as inworld "cloud/pool storage" for deliveries - this is why duplicate sets are such a good idea. There's no need to even try to "pin" a dropbox to a specific vendor, the system will automatically pull a product for delivery from the first dropbox that (1) responds, and (2) HAS the item being requested.<br />
<br />
== '''<span style="color:#00528c">Updating Your DropBox</span>''' ==<br />
<br />
=== Updating With New Products ===<br />
----<br />
The SL grid does not allow one object to load inventory into another object in a different sim/region. You must manually add each of your new packaged products to '''EACH''' DropBox you want them to be in. "Cloud/pool" only applies to '''deliveries''' for customer purchases.<br />
<br />
=== Updating DropBox Version ===<br />
----<br />
See '''[[CasperVend_2/DropBoxes#Upgrading_Your_DropBoxes | this section]]'''<br />
<br />
== '''<span style="color:#00528c">Products Not Showing On Site?</span>''' ==<br />
There are '''four''' common principles behind why product packages may not show up on the website to be added to a new listing. They are: <br />
<br />
: 1) DropBox cannot be contacted<br />
: 2) Duplicated name of notecard/texture/etc. <br />
: 3) Product is "(no transfer)" to YOU, the merchant-owner<br />
: 4) Product is not in the dropbox<br />
<br />
There is also one big reason why product packages don't show on the '''PRODUCTS''' page itself, '''OR''' in the list of products to add to a profile: <br />
: 5) Products have not had a '''[[CasperVend_2/Product_Options | product listing]]''' created yet<br />
<br />
=== Can't be contacted ===<br />
----<br />
Common error points when the DropBox(es) can't be contacted are: <br />
# DropBox(es) not rezzed out (Like all scripted inworld delivery systems, they cannot deliver if not rezzed out...) <br />
# DropBox(es) has no script (need "CasperTech Dropbox" script to stay in the box) <br />
# The sim the DropBox(es) is(are) on is having a snit and not talking to the outside world (the "gone dark" issue mentioned in the backup section below) <br />
<br />
=== Duplicated Names ===<br />
----<br />
Common error is that the product name exactly matches the name of a texture or notecard. <br />
<br />
The popup for product selection is set to filter out duplicates - so this results in new products not showing because the texture or notecard is showing instead. <br />
<br />
# Rename your product package, corresponding notecard, and corresponding texture so that the names are '''ALL''' different from each other.<br />
<br />
=== Product is "no transfer" ===<br />
----<br />
Products MAY end up being effectively "(no transfer)" to you for different reasons: <br />
# Putting a holo demo in the DropBox instead of the holovendor<br />
# An errant script, texture, or other "(no transfer)" item included with the product by accident. (Might be accidentally linked to a build, or accidentally dropped in the contents of a prim.)<br />
<br />
Verify that all your items are transferable TO YOU by looking in the contents of (each) DropBox, waiting for the contents to load, and scrolling the list to the right to see the permissions. Scroll down to see everything in the DropBox and verify whether or not "(no transfer)" is next to any of the items.<br />
<br />
=== Not in the dropbox ===<br />
----<br />
# Did you forget to put it in the dropbox? <br />
# Did you perhaps put the product in the vendor instead of the DropBox?<br />
# When you rezzed (or re-rezzed) the DropBox, did you rez an older version that's missing the new item(s)?<br />
<br />
== '''<span style="color:#00528c">Products Not Showing On Products Page? </span>''' ==<br />
<br />
You won't see '''anything''' on the product page until a listing has been created for the product(s) in question. <br />
<br />
CasperVend does not show product '''packages''' on the '''[https://caspervend.casperdns.com/productsNew.php Products page]''', only completed product '''listings'''. <br />
<br />
You must create your product listings - if all goes well (see previous section for common troubleshooting points) then you'll see your missing packages in the popup for selecting a package to deliver, once you start creating your product listing. <br />
<br />
Start at #9 '''[[CasperVend_2/Quick_Start | on this page]]''' to create your product listings.<br />
<br />
=== Product Selector Popup Not Appearing On Website? ===<br />
----<br />
You may have a browser extension that's blocking the popup product picker window. <br />
<br />
If you are using Chrome, you can start another Chrome window in 'Incognito" mode - use CTL + SHFT + N to start an Incognito window. This disables all the extensions before logging you in. <br />
<br />
If you are using Firefox (or another browser) with a a "no javascript" type extension that allows a temporary override, you need to allow '''casperdns.com''' and '''ajax.googleapis.com''' to be able to see the product picker popup window.<br />
<br />
= '''<span style="color:#00528c">Upgrading Your DropBoxes</span>''' =<br />
:# Verify version: Click the DropBox, and from the popup menu, select "Version".<br />
:# Compare with the list on the '''[[Current_Versions | versions page]]'''.<br />
:# If your DropBox is out of date, '''redeliver''' the pack that your dropbox came from. (Old Bee only has old version.)<br />
:# Once you have a redelivered shipping crate, unpack that.<br />
:# Pull out the '''NEW''' UpgradeBee DROPBOXES ONLY.<br />
:# Rez one in each sim/region you have DropBox(es), and select '''RUN UPDATE'''. <br />
:# The UpgradeBee will fly around and update all of your DropBox(es).<br />
<br />
If you get an error message for "Illegal Task" '''or''' "0 attempted / 0 upgraded / 0 no longer exist / 0 weren't upgraded because..." message, then click the dropbox, and from the popup menu, select "Reset". <br />
<br />
=== "I Don't Have That Many Vendors Out!" ===<br />
----<br />
When you use the "check all" function, it will check '''everyone's''' vendors AND dropboxes on the sim. <br />
<br />
This is normal! <br />
<br />
It cannot actually upgrade anything that's not YOURS - but it will ping CasperVend things from everyone on the sim and see if the items are still rezzed out. <br />
<br />
=== Verifying the update worked ===<br />
----<br />
:* Click the DropBox. <br />
:* Select "Version" from the popup.<br />
:* (If you don't have "version" as an option, they need to be upgraded...) <br />
:* The DropBox will tell you its version in local chat. <br />
<br />
The DropBox '''prim''' will not be renamed by the UpgradeBee - this is normal. If you want the object name to reflect the version, you must rename it manually.<br />
<br />
= '''<span style="color:#00528c">Delivery Errors</span>''' =<br />
<br />
See the '''[[CasperVend_2/Deliveries#Delivery_Errors | delivery errors section]]''' on the transactions page.<br />
<br />
= '''<span style="color:#00528c">E-Mail Self Test Yellow Text Message</span>''' =<br />
:: '''''WARNING: This dropbox failed its e-mail self-test. This means that the box may become uncontactable, which may affect your deliveries. Please pick up this box and re-rez it.'''''<br />
<br />
This is a test feature new with version 2.27 - it's designed to let you know when the sim has blacklisted the dropbox in question. <br />
<br />
Make sure your DropBox is on the '''[[Current_Versions | latest version.]]''' If it's not, then follow '''[[CasperVend_2/DropBoxes#Updating_DropBox_Version | these instructions]]''' to get it up to date.<br />
<br />
This message '''has been removed in current versions.''' If you see any variant of this message, it means your DropBox is '''NOT''' up to date!<br />
<br />
= '''<span style="color:#00528c">Cleanly Deleting Old DropBoxes</span>''' =<br />
'''Properly''' deleting an older (or unused) DropBox is '''essential''' for a cleaner database - following these steps means that the DropBox will flush its contents out of the database before deleting itself. <br />
<br />
'''Remember to "take a copy" FIRST!'''<br />
<br />
# Click the DropBox<br />
# Select "Delete" from the popup menu<br />
# The DropBox will give you a confirmation screen; if you really want to delete it, click the appropriate option<br />
# The DropBox will clear its contents out of the website, before deleting itself inworld<br />
<br />
=== Products Showing That No Longer Exist? ===<br />
----<br />
This issue is most often caused by simply using "Edit > Delete" on an existing DropBox, '''OR''' a DropBox is accidentally returned to your lost & found folder. <br />
<br />
Here's the way to fix this: <br />
<br />
:# Log in to the CasperVend website<br />
:# Go to the '''[https://caspervend.casperdns.com/dropboxes.php DropBoxes page]'''<br />
:# You will see a list of all the DropBoxes the system thinks are still rezzed inworld. <br />
:# Click the '''"contents"''' link next to each dropbox and look through the contents<br />
:# When you find the incorrect dropbox, click '''"Manage"''' on the same line<br />
:# You will be taken to another page<br />
:# To delete that dropbox, select '''"Delete Unit"'''<br />
:# You will get a confirmation popup - click "ok"<br />
:# The system will process, and then reload the main DropBoxes page<br />
<br />
=== Accidentally Returned/Picked Up ===<br />
----<br />
Simply re-rez the DropBox. Your vendors will resume normal delivery operations without needing to touch anything on the website.<br />
<br />
= '''<span style="color:#00528c">The "DropBox Cloud"</span>''' =<br />
<br />
All DropBox(es) you have rezzed anywhere on the grid contribute to the "global product cloud" of your products. This is why it doesn't matter where you're dropboxes are, as long as they are rezzed inworld. <br />
<br />
The website will deliver '''one''' copy of the configured item, from '''the first available''' DropBox that has that product, AND responds in a timely manner. Due to general grid crappiness, sometimes a sim/region doesn't respond as well as it should - and having duplicates on different sims/regions means that the website has the opportunity to use other dropboxes for the delivery of that item instead of completely failing. <br />
<br />
So yes, multiple / duplicate / backup DropBox(es) are not only totally ok, they are actually encouraged!<br />
<br />
== '''<span style="color:#00528c">Setting Up Duplicate DropBoxes</span>''' ==<br />
You may think "backup sets", but it's really "duplicate sets" - the system does not seek out one set as a primary, the dropboxes send the product from (1) the first one to respond to the deliver command, that (2) has the product. If that's on your home sim, then that's where it comes from. If the first one to respond is one of your duplicated locations, then that's where it gets sent from. <br />
<br />
If you like, and you have multiple locations for your DropBoxes, you can work with ONE set as a "master set" of DropBoxes. Then, when you are done adding things in a particular session, simply do the following steps: <br />
<br />
# Right-click, then "Take a copy" of your existing DropBox(es)<br />
# Go to another sim/region where you have long-term rez rights. (If you're Premium and have a Linden Home, this would also be an ideal location) <br />
# Rez out the DropBox(es)<br />
# Wait for the DropBox(es) to talk to the website. <br />
# All set! Remember to leave the DropBox(es) rezzed at all times. <br />
<br />
You may organize your DropBoxes however you'd like, and you can rez however many you'd like (up to the maxmium prim/impact limits of the parcel, of course). <br />
<br />
=== Updating Duplicate DropBox(es) ===<br />
----<br />
If you want the products in all of your DropBox(es) to stay updated compared to each other, you will, unfortunately, need to do that manually. <br />
<br />
You can "designate" one set of DropBox(es) as your "master set" - this is NOT a scripted setting, and NOT something you do on the website, but in this case simply refers to the set that you update FIRST - whether you have it on your build platform (and set up an orb to keep random people from dropping in) or hanging out in your store is up to you. <br />
<br />
There are two ways of doing this: <br />
<br />
==== Adding Individual New Products ====<br />
----<br />
<br />
:# Go to each DropBox location<br />
:# Add the new product(s) to each pertinent DropBox<br />
<br />
If replacing old products, rather than just adding new: <br />
<br />
:# Go to each DropBox location<br />
:# Delete the old copy of the product you are replacing<br />
:# Replace with the new product<br />
<br />
Go around to all dropbox locations and add the new products to the pertinent DropBox(es) via Right-Click > Edit > Contents tab<br />
<br />
==== Replacing Older DropBox(es) ====<br />
---- <br />
<br />
:# Right-click > "Take a copy" of each dropbox that has been updated with new or replacement products <br />
:# Go to each additional DropBox location<br />
:# Delete the old copy rezzed out <br />
:# Replace with the new copy you just picked up <br />
:# Rez an upgradebee <br />
:# Wait for it to boot<br />
:# Click > select "Check All" <br />
:# Wait for it to run<br />
:# When it completes, simply delete the Bee<br />
<br />
You may see more numbers of objects it is checking than what you have/had rezzed out - this is normal, as a "check" will check ANYONE's, not just yours. It '''cannot''' do anything to anyone else's objects (and thus nobody else's upgrade bee can do anything to yours) - it just "pings" every CasperVend vendor or DropBox it knows WAS rezzed on the sim to see if it's still there.<br />
<br />
==== Last One Updated, First One Contacted ====<br />
----<br />
<br />
Usually, the last DropBox that gets updated with a new product is the one that the system tries to contact first.<br />
<br />
=== NOT On The Same Region ===<br />
----<br />
Having boxes containing the same item, on the '''same region''' is generally pointless. The goal behind having duplicate locations is to have reliability in case of sim/region-to-outside-world communication issues. Having all duplicate sets on the same sim/region means that they will all be affected when the sim/region goes out to lunch or runs out of URL's.<br />
<br />
=== On Different Regions ===<br />
----<br />
Having one or more duplicate DropBox(es) (DropBoxes containing the same items) on another region is '''absolutely recommended'''.<br />
<br />
Partly this is so that you have DropBoxes that work even when the simulator/region is down (especially if you have affiliate vendors out on the grid, or multiple locations) but also because simulators/regions occasionally "go dark" and refuse to talk to the outside world. The sim/region will still be up, inworld, and accessible to avatars even in this state, but because it's not talking to the outside world, DropBoxes on these affected sims/regions will be unable to deliver product to customers.<br />
<br />
Having one or more backup sets on other sims/regions reduces the chance that YOUR products won't deliver when customers make a purchase. These backup locations can be linden homes, friend's homes, etc. There are also [[DropBox_Hosting|services on the grid]] that will allow you to rent a few prims just for DropBox purposes.<br />
<br />
= '''<span style="color:#00528c">DropBox Page on Website</span>''' =<br />
Your DropBoxes are now listed on the website, on the [https://wiki.casperdns.com/index.php/CasperVend_2/DropBoxes DropBoxes page]!<br />
<br />
The list is "colour coded" according to how long it's been since the site last contacted the dropbox. It does '''NOT''' mean that it's broken - deliveries will still happen. If you're concerned that it's shown with a colour background other than white, you may click the dropbox inworld and select "reset" - that'll make it contact the website and turn it white. It is '''NOT''' required that you do that - not being contacted doesn't mean it's not working. <br />
<br />
== The Columns ==<br />
:'''Last Seen:''' This is how long it's been since the website last talked to the dropbox. <br />
:'''Version:''' This is the script-reported version of the dropbox. An easy way to tell when you need to [[Current_Versions | check your versions]]. <br />
:'''Location:''' This is the listing of the sim, with a SLURL to the exact location where the DropBox is inworld. <br />
:'''Actions:''' You can "Manage" or view the "Contents" of the dropbox from this column. "Manage" gives you a page where you can ping, update, or delete the dropbox. "Contents" just shows you what's in it.<br />
<br />
== Colour Coding ==<br />
Yellow is for not being contacted for a short time. Pink is for not being contacted for a longer time. <br />
<br />
The variations in yellow and pink do not represent any specific timeframe, they alternate lighter and darker to make it easier for your eyes to follow a specific line.<br />
<br />
= '''<span style="color:#00528c">FAQ / Troubleshooting</span>''' =<br />
<br />
: '''Q. Why'd my vendors suddenly stop delivering notecards / demos / products?'''<br />
:: '''A.''' Things cannot be delivered if the system cannot find the dropbox, and/or cannot find the product items it's been told to send. Therefore, the first points to check are: <br />
::: * Is the item IN the dropbox? <br />
::: * Is the site pointing to the correct item(s)<br />
::: * Have you recently change name on the product / notecard / demo, without updating the website? <br />
::: * Has the sim/region "gone dark"? (If so, the only solution is restart the sim and/or have backup copies on at least one other sim/region.) <br />
::: * How many items are in your dropbox? (Remember if there are too many things in the dropbox, the SL servers seem to make stuff "go missing" - which would also prevent delivery of items.) <br />
::: * Also compare YOUR transaction log with the information in the '''[[CasperVend_2/Deliveries | Transactions & Deliveries]]''' page.<br />
<br />
: '''Q. My customers aren't getting the product after purchase, and the redelivery terminal keeps giving them a "Failed: Couldn't find delivery box for item on SLIFE. This merchant may no longer be using CasperVend." message, when it is, and I am.'''<br />
:: '''A1.''' Reset the DropBox(es). Use the touch menu first - if that doesn't work, then manually Edit > Reset scripts in selection to get them to actually reset. <br />
:: '''A2.''' If you have DropBox(es) on only one sim/region, then we strongly recommend having a backup set (see above) on at least one other sim/region location to reduce the risk of this happening again. <br />
<br />
: '''Q. I have a DropBox which shows as 'live' and as having __ items listed. However, when I open the drop box there are maybe half that amount of items showing inside the box.'''<br />
:: '''A.''' Casper Warden writes: "basically, if items have disappeared from the box, there's two possible reasons...<br />
::: '''1)''' they were no copy and were delivered<br />
::: '''2)''' your sim suffered an inventory failure or rollback<br />
:: in both circumstances the system isn't notified about the change :/ " <br />
:: When items that are no-copy to the merchant (such as breedable things) get sold, the # in the floaty text above the dropbox does NOT get updated.<br />
<br />
:'''Q. I got this message: "CasperVend DropBox: Items in the database seem to be out of sync! Re-uploading."'''<br />
:: '''A.''' Nothing to worry about - the system's self-check has determined that there is lag, either on the sim/region or in the grid itself. Once or twice per DropBox is normal (if you have multiple DropBoxes, you'll get several messages, but should just be one or two from each.) <br />
:: The only time to worry is when you get the message several times a day - that would indicate a sim/region communication problem, or that Casper is working on the backend servers. <br />
<br />
:'''Q. My last shop location is no more, I don't have access to it, and it keeps trying to send the OLD landmark. How can I fix this? '''<br />
:: '''A1.''' You'll need to edit *everywhere* you have it marked - usually this is in each and every single product listing - and set them up with the new landmark. <br />
:: '''A2.''' It is STRONGLY RECOMMENDED that you use a landmark name like '''"(your shop) - Main location"''' - rather than the default LL format that includes the sim/region name. Renaming your landmarks to something simple and WITHOUT the sim/region name means that when you have to move in the future, you can just outright swap the landmarks, without having to go through the hassle of updating every single product every time you change landmarks. <br />
<br />
:'''Q. I keep getting messages of "That item is no longer available or doesn't belong to you." when it is, and it does. '''<br />
:: '''A.''' Pick up and re-rez the DropBox, that should get rid of the spurious errors.</div>24607dde-d704-4db7-afa0-d9edc17c926chttps://wiki.casperdns.com/index.php?title=CasperSafe_Security_Orb&diff=14734CasperSafe Security Orb2021-07-01T21:40:50Z<p>24607dde-d704-4db7-afa0-d9edc17c926c: /* Main Menu for Admins */</p>
<hr />
<div>{|align=right<br />
|__TOC__<br />
|}<br />
<br />
{{Warning|Orb not ejecting? Please see the [[#Checklist_for_Automatically_Ejecting_Avatars|Checklist for Automatically Ejecting Avatars]], particularly the "Disallow by default" option. This is the most common support query for CasperSafe.}}<br />
<br />
= <span style="color:#00528c">'''About CasperSafe'''</span> =<br />
<br />
CasperSafe is a high-tech security and visitor tracking system. Its features include: <br />
<br />
* Self-contained configuration - no notecards<br />
* Fewer scripts than competing products - 4 instead of 11-13 scripts<br />
* CasperLet Support<br />
* Visitor Tracking option<br />
* Region-wide operation<br />
* Capable of monitoring many parcels at once<br />
<br />
{{Information|Depending on your viewer configuration (fonts, UI size, etc.) the length of the option names may not be identical to what's shown here. Popup menus shown here are from Viewer 3.}}<br />
<br />
= <span style="color:#00528c">'''What's in the Box?'''</span> =<br />
The following named items are in the shipping crate: <br />
:: CasperSafe Enforcer<br />
:: CasperSafe Parcel Link Tool<br />
:: CasperSafe Psychic Link Script (Read the instructions!) <br />
:: CasperSafe Security Orb<br />
<br />
Along with a landmark to the CasperTech store.<br />
<br />
= <span style="color:#00528c">'''What's with the 'war is peace' stuff?'''</span> =<br />
<br />
The orb has been themed in several ways with tongue-in-cheek references to George Orwell's 1984, a novel about totalitarian control, monitoring and mind control. It's not a political statement, just a cultural reference.<br />
<br />
= <span style="color:#00528c">'''Quick Setup Steps'''</span> =<br />
:# Rez the shipping crate and unpack<br />
:# Rez out the CasperSafe Security Orb<br />
:# '''[[CasperSafe_Security_Orb#Add_Areas | Add areas]]''' and/or '''[[CasperSafe_Security_Orb#Link_to_Rental_Unit | link to rental unit]]'''<br />
:# Rez (and deed if necessary) the '''[[CasperSafe_Security_Orb#CasperSafe_Enforcer | Enforcer unit]]'''<br />
:# Add people to appropriate '''[[CasperSafe_Security_Orb#Access_Levels | access lists]]'''<br />
:# Arm the orb<br />
<br />
See the sections below for explanations of all the options.<br />
<br />
= <span style="color:#00528c">'''Configuration Tips'''</span> =<br />
<br />
CasperSafe will save its configuration on the server. Like CasperLet and SimpleSit, this is saves the information against the UUID of the device, barring a complete script reset (which makes it forget everything) or shift-drag-copy (the copy that is left behind has both reset the script AND has a new UUID and thus no old configuration.) <br />
<br />
:* Takes about 20-30 seconds to save configuration changes. <br />
:* Configuration is kept when you "Take a copy" '''then''' Rez the copy<br />
:* Configuration is '''NOT''' kept when you shift > drag > copy (this resets the script) <br />
:* Like CasperLet, the script tracks the UUID of the device. New device = new UUID, thus shift > drag > copy = New device and new UUID. <br />
:* Information will NOT transfer between two unrelated or different version orbs. (This would be a hassle for landlords, where different orbs are expected to have different individual configurations depending on the renter.)<br />
:* When used with CasperLet, the owner and any CasperLet managers are automatically admins<br />
:* When used with CasperLet, the primary tenant + additional subtenants on that rental are added automatically to the SUBADMIN access list. <br />
<br />
CasperSafe is '''not''' meant to be configured via the website - while this may make it less convenient, this does ensure that it continues to function despite any website outage.<br />
<br />
=== Checking Version Number ===<br />
----<br />
Because the UpgradeBee does '''NOT''' rename the object, if you wish to verify that your orb(s) have been updated, you will need to edit > contents tab > right-click on one of the scripts > select "Properties" > check the version number in the description field. See the '''[[Current_Versions | versions page]]''' for current version number and changelog information.<br />
<br />
= <span style="color:#00528c">'''Security Settings & Levels'''</span> =<br />
<br />
== '''Access Levels''' ==<br />
<br />
When Admins click into the access menu, they will get the following options: <br />
{| <br />
| [[File:CasperSafe - Access - Main.png|350px|thumb|left|Access main menu - click to see larger version.]]<br />
|}<br />
<br />
When Subadmins click into the access menu, their options will be a little different: <br />
{| <br />
| [[File:CasperSafe_-_Subadmin_-_Access_Version.png|350px|thumb|left|Subadmin version of access menu - click to see larger version.]]<br />
|}<br />
<br />
== '''Access Level Chart''' ==<br />
<br />
{| class="wikitable"<br />
|-<br />
! Main Menu Option<br />
! Guests<br />
! SubAdmins<br />
! Admins<br />
|-<br />
| Areas <br />
| No<br />
| No<br />
| Yes<br />
|-<br />
| Arm / Disarm<br />
| No<br />
| Yes<br />
| Yes<br />
|-<br />
| Lockdown<br />
| No<br />
| Yes<br />
| Yes<br />
|-<br />
| Link / Unlink (rental units)<br />
| No<br />
| No<br />
| Yes<br />
|-<br />
| Access Menu<br />
| No<br />
| Yes (subadmins / guests / ban list)<br />
| Yes<br />
|-<br />
| Options<br />
| No<br />
| No<br />
| Yes<br />
|-<br />
| Visitor Control Panel<br />
| No<br />
| Yes, no sales<br />
| Yes, with sales<br />
|}<br />
<br />
: '''Admins:''' This is the owner, plus any additional designated avatars added to the orb's Admin list. <br />
: '''SubAdmins:''' Usually subadmins are the tenants of a landlord. As a result, they will not have access to the options list or other higher administrative functions of the orb. <br />
: '''Guest:''' This option allows you to add a mostly permanent "whitelist" of allowed guests. Guest level does '''not''' come with menu access to the orb. <br />
: '''Temporary:''' Like the "Guest" level, except that people added to the temporary list are automatically removed after they leave the sim/region. <br />
: '''Banned:''' This option allows you to add to a list of "never allowed" avatars. Anyone on the ban list will automatically be ejected/teleported home (provided they HAVE a home point set...) upon arrival, if ejection is on and an enforcer is out (and properly deeded if necessary.) <br />
<br />
=== Security Notes ===<br />
----<br />
Each CasperSafe can only hold '''one''' set of security options. <br />
<br />
If you need to have different security settings for different areas, then you'll need one orb per set of security settings. <br />
<br />
Yes, you can rez multiple orbs on the same sim/region.<br />
<br />
:* When used with CasperLet, the owner and any CasperLet managers are automatically admins<br />
:* When used with CasperLet, the primary tenant + additional subtenants on that rental are added automatically to the SUBADMIN access list. <br />
:* Two CasperTech support avatars are added to the whitelist to make it easier to provide any needed support: Casper Warden and CasperHelp Resident.<br />
:* Lockdown mode automatically ends when the entire sim is empty of all allowed avatars.<br />
<br />
== '''Warning Times''' ==<br />
Minimum warning time of 10 seconds (default setting of 30 seconds). <br />
<br />
Lockdown mode warning time of explicitly 00 seconds (instantly ejected), regardless of normal warning time setting. Lockdown mode ends automatically when all allowed avatars leave the sim/region. <br />
<br />
If the avatar is explicitly on the orb's ban list "instant eject" .<br />
<br />
=== Ejected without warning? ===<br />
----<br />
CasperSafe '''always''' sends a warning first, before ejecting (when ejecting is properly configured) '''unless''' it is in "lockdown" mode. <br />
<br />
The times a visitor may not see the warning are: <br />
: 1) If they muted the orb<br />
: 2) If what they think was CasperSafe is actually a neighbour's non-CasperTech orb set to the wrong distance. <br />
<br />
Visitors normally receive a notice, either by popup or by local chat, indicating what they were ejected by.<br />
<br />
== '''CasperSafe Enforcer''' ==<br />
<br />
{{Warning|The CasperSafe Enforcer may ask for permission to return objects. Objects will ONLY be returned IF permissions are granted AND the option to return prims is enabled on the CasperSafe Orb. If activated, the orb will return prims belonging to an avatar when they are '''ejected'''. '''BE CAREFUL''' with this option - we accept no responsibility for any damage caused.}}<br />
<br />
This is the widget that actually does the ejecting / teleport home functions. Thus it is required if you actually want to be able to boot avatars out of the protected area - Otherwise CasperSafe operates in "Warning Mode" which basically nags the avatars instead. <br />
<br />
Like the '''[[CasperLet/Prim_Counter#Prim_Counter_Basics | CasperLet Prim Counter]]''', in order to function properly, the Enforcer widget must be owned by the LAND OWNER. If the land is owned by an individual, that individual must REZ the Enforcer widget. If the land is owned by a group, the Enforcer must be REZZED by an individual with the same group tag as the parcel, and they must then DEED the Enforcer to the group. If there are multiple land owners, then you will need one Enforcer per land owner.<br />
<br />
The permissions of the Enforcer widget are copy & transfer so that it can be deeded to the appropriate land owners.<br />
<br />
{{Critical|For security reasons, the enforcer will only respond to CasperSafe orbs belonging to its '''owner''', or in the case of the enforcer being deeded to group, orbs belonging to the either '''the owner or the previous owner''' (because the land owner isn't always the orb owner.) }}<br />
<br />
'''UPDATES:''' The enforcer only needs to be replaced when a new enforcer version goes out.<br />
<br />
=== Using Enforcer On Group Land Where You're Only Renting ===<br />
----<br />
:# Rez the enforcer - this sets a "bit" so that it know you're the original owner<br />
:# Rename it so you can find it in your inventory<br />
:# Pick up the enforcer<br />
:# Pass THAT copy of the enforcer to your landlord, so THEY can rez it out<br />
:# Landlord will need to deed the enforcer to the group (if group owned land)<br />
<br />
Do '''NOT''' pass over a fresh one that you haven't rezzed first, because it will NOT recognize instructions from your CasperSafe orb.<br />
<br />
=== Enforcer Must Stay Rezzed ===<br />
----<br />
The enforcer will not be able to eject avatars if it is only in your inventory, so yes, the enforcer '''must stay rezzed.''' <br />
<br />
=== One Enforcer Per Parcel ===<br />
----<br />
You only need one (1) enforcer '''per parcel''' - see the '''[[CasperLet/Prim_Counter#Sample_Land_Configurations | prim counter]]''' page for rezzing, when when you have to deed. <br />
<br />
The enforcer will turn all black when it is '''properly''' deeded or rezzed - this is normal and does NOT mean it's broken.<br />
<br />
=== Enforcer and Autoreturn ===<br />
----<br />
If you want the enforcer to utilize autoreturn, you must: <br />
<br />
:# Rez the CasperSafe orb '''first'''. <br />
:# Set up the autoreturn options in settings<br />
:# '''Then''' rez and deed the enforcer.<br />
<br />
=== Enforcer, Group Detection, Autreturn and You ===<br />
----<br />
If you are using '''group detection''', it is '''highly recommended''' that you '''do NOT''' use the object return feature, because people will always forget their group tag, and having object return on may result in an individual having their objects returned.<br />
<br />
= '''<span style="color:#00528c">Land Configuration - When Security Is Required</span>''' =<br />
All examples are on a '''per-region''' basis, and the Enforcer is '''ONLY''' required when you need security on an area in a parcel. If you are simply using it for visitor tracking, no enforcer is needed. <br />
<br />
Even if you have multiple CasperSafes on a parcel for different security settings, you only need ONE Enforcer per parcel. <br />
<br />
The CasperSafe Enforcer cannot operate across sim boundaries; you will need to repeat the appropriate steps for each sim/region that you have. <br />
<br />
{| class="wikitable" <br />
|-<br />
! style="white-space: nowrap; background: #33CCFF; border: 2px solid #383838;" | Land Owners On Sim/Region<br />
! style="white-space: nowrap; background: #33CCFF; border: 2px solid #383838;" | Actions To Take With CasperSafe Enforcer<br />
|-<br />
| Shared land, one parcel <br />Owned by YOU<br />
| <br />
# Rez '''one''' CasperSafe Enforcer, on land YOU own<br />
# No deeding required - just rez and wait<br />
# Repeat on each additional sim/region you have<br />
|-<br />
| Shared land, one parcel <br />Owned by ONE other avatar<br />
| <br />
# Transfer the CasperSafe Enforcer to THAT avatar<br />
# THEY must rez out ONE CasperSafe Enforcer on land owned by THEM<br />
# No deeding required - just rez<br />
# Repeat on each additional sim/region you have<br />
|-<br />
| Shared land, one parcel <br />Owned by ONE land group<br />
| <br />
# Rez out ONE CasperSafe Enforcer on land owned by that group<br />
# Right-Click > Edit > "Share with group" > "Deed"<br />
# Repeat on each additional sim/region you have<br />
|-<br />
| Shared land, multiple parcels <br />Some owned by YOU<br />Some by ONE land group<br />
| <br />
# Rez out one CasperSafe Enforcer on EACH group-owned parcel<br />
# Right-Click > Edit > "Share with group" > "Deed"<br />
# Rez out one CasperSafe Enforcer on EACH parcel owned by you<br />
# No deeding required on the land YOU own - just rez<br />
# Repeat on each additional sim/region you have<br />
|-<br />
| Shared land, multiple parcels <br />Owned by MULTIPLE land groups<br />
| <br />
# Rez one CasperSafe Enforcer PER land group, PER parcel<br />
# Right-Click > Edit > "Share with group" > "Deed"<br />
# Repeat on each additional sim/region you have<br />
|}<br />
<br />
= <span style="color:#00528c">'''Monitoring Areas'''</span> =<br />
Avatars are tracked by the area they're in. If an avatar is registered as entering two areas '''at the same time''' that have identical names, the system will end the first visit to avoid duplicates. <br />
<br />
Please ensure each area that is defined has its own unique name to avoid this! <br />
<br />
== Automatic Settings ==<br />
: * When used with CasperLet, the owner and any CasperLet managers are added automatically to the ADMIN access list. <br />
: * When used with CasperLet, the primary tenant + additional subtenants on that rental are added automatically to the SUBADMIN access list. <br />
: * Lockdown mode automatically ends when the sim/region is empty of all allowed avatars.<br />
<br />
=== Note for Skyboxes ===<br />
----<br />
<br />
If you only want to monitor an area NEAR a skybox, set the orb to monitor a '''range''' instead of the parcel. Parcel will assume you want to keep watch over all of the parcel, from "floor to ceiling".<br />
<br />
== Custom Areas ==<br />
'''Custom Areas: Suitable for odd shaped parcels, or a specific square/rectangular size within a parcel - Limited only by available memory'''<br />
<br />
:* Click for menu<br />
:* Select "Areas" <br />
:* Select "Add" <br />
:* Select "Custom" <br />
:* Corner markers will appear<br />
:* Drag the lower marker to the lowest corner of the area you want to monitor<br />
:* Drag the upper marker to the uppermost corner of the area you want to monitor<br />
:* Click one of the markers<br />
:* Select Save<br />
:* Name the area<br />
:* Done! <br />
<br />
If you accidentally manually delete one marker, the corresponding one will self-delete as well.<br />
<br />
==== Custom Area Issues ====<br />
----<br />
:# "Object Entry" '''must be allowed''' for ALL parcels you are dragging custom markers across.<br />
:# Parcels with autoreturn '''must''' give you enough time to do what you need to do before it will send them back. (You can always set autoreturn back to 1 when you're done.) <br />
<br />
Otherwise you'll see things like particles flying completely out of the parcel, and custom area markers/nodes being automatically returned.<br />
<br />
== Custom Range Radius ==<br />
'''Custom Ranges: Number limited only by amount of available memory in the orb.'''<br />
<br />
To set a custom area: <br />
<br />
:* Click the orb<br />
:* Select "Areas" <br />
:* Select "Add" <br />
:* Select "Range" <br />
:* Enter in the detection range, in meters, and click "Send" <br />
:* Enter name of the area, and click "Send" <br />
:* Done!<br />
<br />
Range = Radius. &nbsp;&nbsp;'''''[https://en.wikipedia.org/wiki/Radius What is a radius?]'''''<br />
<br />
== Parcel Link ==<br />
'''Number of Parcels: Limited only by amount of available memory in the orb.'''<br />
<br />
The Parcel Link Tool allows CasperSafe to be paired with one or more parcels. The Parcel Link Tool must be '''used''' on the parcel that will be linked to the CasperSafe orb, and '''ONLY''' by the owner of the orb. (Admins and subadmins cannot add a parcel using the Parcel Link Tool because the Tool is no-transfer.) This may be rezzed on any parcel and moved over, just be sure to allow a minute or two for it to pick up the change in parcels. <br />
<br />
: '''1)''' Rez the CasperSafe Security Orb on the land you want it to monitor<br />
: '''2)''' Rez the "Parcel Link Tool" - You will get these messages in local chat: <br />
Touch me to pair this parcel with your CasperSafe orb. <br />
Make sure you have started pairing on the orb by choosing AREA -> ADD -> PARCEL, first.<br />
I'm now over parcel ''((parcel name as seen in "about land" floater))''. Touch to register with a CasperSafe Orb.<br />
: '''3)''' On the CasperSafe orb, click for the popup menu<br />
: '''4)''' Select "Areas" <br />
: '''5)''' Select "Add" <br />
: '''5)''' Select "Parcel" <br />
: '''6)''' Then click the Parcel Link Tool. You'll see the following messages in local chat: <br />
OK. Trying to find a CasperSafe orb, please stand by.<br />
Alright, all done!<br />
Pairing process ended.<br />
: '''7)''' The Parcel Link Tool will self-delete when the parcel pairing process is completed. <br />
<br />
Pairing process usually takes 1-2 minutes, but may be longer if the region is heavily lagged.<br />
<br />
== Rental Unit Pairing ==<br />
=== '''Ownership''' ===<br />
----<br />
Rental unit AND the CasperSafe orb '''must''' be owned by the same avatar. This is for security reasons. (If anyone could do this, then anyone could control your security orb without your knowledge or permission.) <br />
<br />
=== '''Pairing Process''' ===<br />
----<br />
<br />
'''Pairing limit: 1 rental unit per orb'''<br />
<br />
'''NOTE:''' CasperSafe may be paired with only ONE rental unit. If you have multiple rental units out, AND you want to pair CasperSafe to the units, you'll need one CasperSafe per unit. <br />
<br />
: '''1)''' Rez CasperSafe Security Orb near the rental unit<br />
: '''2)''' Click CasperSafe for the main menu<br />
{| <br />
| [[File:CasperSafe_-_Main_Menu_-_Unarmed.png|350px|thumb|left|Default main menu - click to see larger version.]]<br />
|}<br />
: '''3)''' Select "LINK". You'll get a popup with instructions: <br />
{| <br />
| [[File:CasperSafe - Link Menu.png|350px|thumb|left|Default main menu - click to see larger version.]]<br />
|}<br />
: '''4)''' Drop the "Psychic Link Script" into the corresponding rental unit<br />
: '''5)''' Watch messages in local chat. If all goes well, you should see: <br />
Okay, let's have a look here..<br />
Ooh, CasperLet! Good choice! Searching for the orb..<br />
Cool! I'm paired with ''((name of rental unit))'' (Key: ''((uuid string))'' )<br />
Pairing process ended. <br />
: '''6)''' The orb will also add the CasperSafe system owner as an ADMIN automatically. <br />
<br />
Pairing process usually takes 1-2 minutes, but may be longer if the region is heavily lagged.<br />
<br />
=== CasperLet Manager Auto-Update Timing ===<br />
----<br />
<br />
CasperSafe will automatically pick up changes to CasperLet managers, '''HOWEVER''' it is not instant - It will take time to filter through, and will be the next time the rental unit updates info to/from the server.<br />
<br />
= <span style="color:#00528c">'''Main Menus'''</span> =<br />
<br />
=== Main Menu for Admins ===<br />
----<br />
<br />
By default, when you first rez out CasperSafe, the orb is in the "unarmed" state. When unarmed, the orb automatically runs in "discreet mode" in order to be kinder to region resources. <br />
{| <br />
| [[File:CasperSafe_-_Main_Menu_-_Unarmed.png|350px|thumb|left|Default main menu - click to see larger version.]]<br />
|}<br />
<br />
When you choose to arm the orb, you will also have an extra "lockdown" option, as shown here: <br />
{| <br />
| [[File:CasperSafe - Main Menu - Armed Mode.png |350px|thumb|left|Armed mode - click to see larger version.]]<br />
|}<br />
When CasperSafe is armed, the base menu will also show the option "Lockdown" - this changes the operation mode to instant eject (reduced from the normal minimum of 10 seconds), and increases the scan frequency in order to detect possible threats more quickly.<br />
<br />
Also, when someone arrives who is not on any of the access lists, admins will get a popup asking them if they want to add the new arrival on a temporary or guest basis, or whether to ban.<br />
<br />
=== Main Menu for SubAdmins ===<br />
----<br />
Subadmins will typically be tenants of a landlord, and will not have administrator access to the higher functions of the security orb; they will only have access to the following menu items: <br />
:* Access list (to add fellow subadmins, guests and temporary guests) <br />
:* Arm/Disarm/Lockdown<br />
:* Visitor stats (if enabled)<br />
<br />
=== About Lockdown mode===<br />
----<br />
If the orb is currently '''in''' "lockdown" mode, the lockdown option will change to "stand down". <br />
<br />
This automatically disables itself when everyone ON the access list has left the sim/region - there is no time limit beyond that. <br />
<br />
Lockdown mode changes the operation to instant eject (from the normal minimum of 10 seconds), and uses slightly more script time than normal operation (see '''[[CasperSafe_Security_Orb#Script_Times | Script Times]]''' for details) in order to detect possible intrusions faster.<br />
<br />
= <span style="color:#00528c">'''Security Menus'''</span> =<br />
<br />
=== '''Configuration Options Menus''' ===<br />
----<br />
These are the default settings for the options menu, as it ships from CasperTech: <br />
{| <br />
| [[File:CS_Config_Options_Page_1.png|350px|thumb|left|Default Options page 1 - click to see larger version.]] | [[File:CS_Config_Options_Page_2.png|350px|thumb|left|Default Options page 2- click to see larger version.]]<br />
|}<br />
<br />
== '''Configuration Options Explanations''' ==<br />
<br />
{| class="wikitable"<br />
|-<br />
! Options Items<br />
! What it does<br />
|-<br />
| Floating Text<br />
| This turns the radar on and off. Having the radar on will use more script time and processing. <br />
|-<br />
| Disallow by default<br />
| When on, this will eject anyone who's not on the access list. <br />
|-<br />
| Discreet mode<br />
| When on, this slows down the timers to reduce lag. It won't be as responsive, but it will be kinder to region resources. <br />
|-<br />
| Eject from parcel <br />
| When on, this will eject unwanted visitors after the warning period has ended. <br />
|-<br />
| Teleport Home<br />
| When on, this will teleport unwanted visitors to their home point. <br />
|-<br />
| Add to parcel ban list<br />
| When on, this will add ejected avatars to the parcel's land ban list (not the ban list in the orb). <br />
|-<br />
| Warning Time<br />
| This controls how long the avatar can stay before being ejected, if eject mode is on. In "Warning mode" (which is the default, if there is no Enforcer present and/or properly deeded) this is how long before CasperSafe sends another warning to the intruding avatar. The shipped default is 30 seconds, and may be reduced to 10 seconds for normal operation. When in lockdown mode, there is no warning time. <br />
|-<br />
| Age Limit<br />
| When on, you configure the minimum number of days of account age before avatars are allowed in to the protected area. <br />
|-<br />
| Script Limit<br />
| When on, you configure the maximum amount of scripts an avatar may be wearing/using before they are allowed in to the protected area. <br />
|-<br />
| Visitor Tracking<br />
| When on, this tracks visitors and sends visitor data to the CasperTech website. Visitors cannot (currently) be filtered by admin/subadmin/guest levels; access list data is not sent to the website. You must have an '''[[CasperSafe_Security_Orb#Monitoring_Areas | area defined]]''' before tracking will actually take place. (The orb needs to know where to keep watch.) <br />
|-<br />
| Group members are guests<br />
| When on, allows members of the group the orb is rezzed under into the protected area. "Guest" access does not include any part of orb menus. <br />
|-<br />
| Group members are subadmins<br />
| When on, allows members of the group the orb is rezzed under both into the protected area '''and''' gives them subadmin access to the orb itself. <br />
|-<br />
| Limit detection to current parcel<br />
| When on, this limits detection ranges to within the borders of the parcel the orb is rezzed on. This prevents things like the orb's ejecting/banning from affecting users on other (unrelated) parcels. <br />
|-<br />
| Return prims when ejected<br />
| When on, uses the scripted prim autoreturn feature. This is not recommended in combination with group detection, because people often forget their group tag when they try to rez objects. <br />
|-<br />
| Don't send notifications to admins <br />
| When on, this prevents the orb from sending notifications to users on the "Admin" access level. By default, all messages are delivered via llRegionSay to prevent IM's from capping while you are offline. (If IM notifications are prefered, there is an optional script in the orb's shipping crate that will do this.) <br />
|-<br />
| Don't send notifications to subadmins<br />
| When on, this prevents the orb from sending notifications to users on the "SubAdmin" access level. By default, all messages are delivered via llRegionSay to prevent IM's from capping while you are offline. (If IM notifications are prefered, there is an optional script in the orb's shipping crate that will do this.)<br />
|-<br />
| Send notifications to guests<br />
| When on, this will send notifications to users on the "Guest" access level. By default they don't receive notifications. <br />
|-<br />
| No-Fly Zone<br />
| When on, the flying avatar is warned. If "Eject" is on, then the user is ejected from the area. If "Teleport Home" is on, then the user is teleported home. There is no height limit on flight detection. <br />
|-<br />
| Render Weight Limit<br />
| When on, you set the maximum avatar complexity that individual avatars should be at. Users above that point will be warned. If "Eject" is on, then the user is ejected from the area. If "Teleport Home" is on, then the user is teleported home. <br />
|}<br />
<br />
=== Memory Limits ===<br />
----<br />
Data about names for Admin/Subadmin/Guest lists are stored IN the device. Consequently every name that's added will cause the available memory to decrease, and it will give you a local chat message indicating how much memory is left. Once the available memory gets below a certain point (somewhere around 300 names), the orb will crash - so it's up to you to keep an eye on how much memory is being used. <br />
<br />
You CAN rez multiple orbs if you are getting low in memory on the first one.<br />
<br />
= <span style="color:#00528c">'''Render Weight'''</span> =<br />
<br />
The CasperSafe orb has the ability to eject avatars if their render weight (ARC) is too high. However, please be aware that:<br />
<br />
* It is '''not the same thing''' as avatar complexity, but represents the same thing.<br />
* It has a maximum value of 500,000. If you set your limit higher than this, it'll have no effect.<br />
* A render weight of 500,000 is '''roughly''' equivalent to an avatar complexity of 1 million.<br />
* Render weight is calculated by viewers, not the simulator, so it will only work if there are other people nearby.<br />
<br />
Please understand that this is not a predictable or reliable figure, it can vary based on many different factors, and can suffer from random "surges" with apparently no cause. For this reason, we '''do not recommend''' that you enforce a render weight limit. However, the option is there if you require it.<br />
<br />
We've '''[https://jira.secondlife.com/browse/BUG-100791 opened a Jira ticket]''' to request script access to avatar complexity. Vote if you want this feature!<br />
<br />
= <span style="color:#00528c">'''Checklist for Automatically Ejecting Avatars '''</span> =<br />
# Is the Enforcer rezzed out by the land owner? <br />
# Is the enforcer ON the parcel? <br />
# If it is group land, is the Enforcer deeded to the group? <br />
# Is it multiple parcels - and is there one Enforcer PER PARCEL? <br />
# Did you configure an area? (The orb needs to know where to kick avatars FROM...) <br />
# Under Options > Disallow, did you turn "disallow by default" to '''ON'''?<br />
# Is the orb even armed? (You should see "disarm" in the popup menu if it IS armed) <br />
# Has the avatar to be ejected been standing still BEFORE you turned on "disallow by default"? Once the avatar moves, they will be seen and ejected. If they stand still and '''don't''' move, they won't be ejected yet. <br />
# Are you using '''only''' the "teleport home" option? (SL limitation: If the avatar does NOT have a home point set, or the home point no longer exists, the avatar cannot be "sent home".) <br />
<br />
=== Group Tag Issues ===<br />
----<br />
If you have the CasperSafe set to only allow group members, your group members '''MUST ALREADY''' be wearing the group tag when they teleport in. CasperSafe will not recognize if they change tags once they arrive - they'll have to tp out then back to get the orb to see the proper group.<br />
<br />
= <span style="color:#00528c">'''Visitor Tracking '''</span> =<br />
<br />
:* Visitor tracking turns ON or OFF using the options menu (so only Admins may turn this on or off.) <br />
:* Visitor data WILL be sent to CasperTech servers when turned on.<br />
:* When visitor tracking is enabled, the "VISITORS" button will change to "CNTRL PANEL" - click the control panel button to get a link for the web-based visitor stats.<br />
:* You must also '''[[CasperSafe_Security_Orb#Monitoring_Areas | define an area]]''' for the tracking to monitor before visitor tracking will actually take place<br />
:* Visitor tracking does '''not''' require land ownership. You can rent in a mall and still track your mall store visitors.<br />
<br />
=== Missing or Ghosted Visitors ===<br />
----<br />
Every time an avatar enters or leaves an area (and visitor tracking is turned on), the orb must send a message to CasperPanel to let it know. It is expected that - from time to time - one of these message may be lost/dropped, which will either cause a missing visitor, or a visitor remaining visible who has really already left. <br />
<br />
This is normal and expected, from time to time, however it shouldn't happen too often. If you are experiencing this problem very often, please contact '''[[CasperVend_2/Getting_Help#2.29_When_Casper_is_offline:_By_IM-to-Webform | CasperTech support]]''' since there may be something wrong that we need to look at. <br />
<br />
You can fix this by resetting your orb. Your "current visitors" list will also be cleared when the region restarts.<br />
<br />
= <span style="color:#00528c">'''CasperVend and CasperSafe'''</span> =<br />
There is NO linking process required to hook up CasperSafe with CasperVend - this is automatic behind the scenes. If you have visitor list enabled, you will see icons that represent repeat visits, and whether they bought something on that visit. <br />
<br />
= <span style="color:#00528c">'''Customising Your Orb'''</span> =<br />
The default CasperSafe Orb object has 1 prim and 2 faces: <br />
:* The main decorative texture with triangular shapes is face #0<br />
:* The "war is peace" strip is face #1<br />
:* The orb does '''NOT''' check for prim creator - you can use any object to put the scripts in<br />
<br />
=== Textures & Custom Objects ===<br />
----<br />
If you simply don't want the "war is peace" strip to change, there is a notecard in the shipping crate labeled '''DISABLE_TEXTURE_CHANGE''' - simply drop that in the orb's contents, and it will disable further color changes to that strip. <br />
<br />
Alternately, you can rez a simple prim sphere and copy all the contents of the orb to that - an unmodified legacy prim sphere has only face #0. <br />
<br />
'''NOTE:''' Currently, the "Disable texture change" does NOT change the texture animation. Please keep that in mind when making a custom object. <br />
<br />
=== Notifications ===<br />
----<br />
If you want the notifications for your staff to arrive as an object IM instead of a llRegionSay message (so they can potentially reach your staff when they are not in the sim/region) then simply drop the script labeled '''Optional Plugin: Send IMs to staff''' into the orb object, and it will do the rest. <br />
<br />
The optional plugin script is '''open source''' - therefore any changes you make to the script are '''your responsibility''', and are unsupported by CasperTech.<br />
<br />
==== Popup Menu Notifications ====<br />
----<br />
You cannot turn these off at this time, but that functionality is expected to be added in the next release.<br />
<br />
= <span style="color:#00528c">'''API Information'''</span> =<br />
<br />
Per Casper: <br />
'''We haven't yet published the API for CasperSafe.'''<br />
<br />
There is currently no date for when the API will be released. When it is released, it will be inserted into this space. If you are still seeing THIS message, the API information has not been released yet.<br />
<br />
= <span style="color:#00528c">'''Limitations'''</span> =<br />
:* No website configuration<br /> <i>All configuration of the orb itself is done inworld. While it stores minor configuration information online as a backup, it is designed to stay functional even if CasperTech web services have issues.</i><br />
:* Shift-drag-copy loses configuration<br /><i>The new copy will lose all configuration due to a new UUID created which has no record on the database. You may, however, '''take a copy''' of an orb with the desired configuration and rez as many additional copies of that as you please. </i><br />
:* Cannot filter visitor tracking by access level <br /><i>Access level of the avatar is not sent with the visit statistics. </i><br />
:* One orb per set of security settings<br /><i>While the orb can track multiple areas and parcels without an issue, it is only designed to hold ONE set of security settings. You cannot choose to eject people from one area while not ejecting them from another - you'll need multiple orbs. Yes, you can rez multiple orbs on a parcel and a sim/region. </i><br />
:* Land bans limited to the parcel the CasperSafe Enforcer is on<br /><i>llAddToLandBanList only works for the parcel the enforcer is currently on.</i><br />
:* One CasperSafe Enforcer per parcel<br /><i>If the land is group owned, the Enforcer unit will need to be deeded, using the same process as if you were '''[[CasperLet/Prim_Counter#How_to_Properly_Deed_a_Prim_Counter | deeding a prim counter.]]'''</i><br />
:* Deleting areas doesn't remove current visitors<br><i>If you delete an area, any avatars shown as currently visiting the area on the website will not be removed until the next time the orb is reset or the region is restarted.</i><br />
:* No avatar height restrictions<br /><i>CasperSafe does not support any sort of avatar height restriction. Since the introduction of mesh avatars, you can no longer depend on avatar height as being a psuedo-reliable indicator of the avatar's "age". There are many non-child avatars that are also short, and non-human avatars can come in many sizes as well. Height restrictions are therefore irrelevant today, and would eliminate too many '''legitimate''' avatars.</i><br />
:* Cannot manually eject via the orb<br /><i>CasperSafe is only set up to eject in response to an allow prompt.</i><br />
<br />
= <span style="color:#00528c">'''Script Times'''</span> =<br />
<br />
These timings were measured over a 24 hour period, on a relatively quiet full region (Izanagi). Your mileage may vary, and times may be higher on busy sims.<br />
<br />
: UNARMED - 0.003ms<br />
: DISCREET - 0.003ms<br />
: ARMED - 0.004ms<br />
: LOCKDOWN - 0.005ms<br />
: ARMED + RADAR - 0.006ms<br />
: LOCKDOWN + RADAR - 0.007ms<br />
<br />
= <span style="color:#00528c">'''Error Messages'''</span> =<br />
: '''"Script asking non-owner for run time permissions only owner can grant" '''<br />
:: This is only referring to the scripted autoreturn permissions. They can only be granted by an OWNER in the land group. All other functions of the enforcer are unaffected by granting - or not granting - the autoreturn capability.<br />
<br />
:'''ChangeQueue is full! Too many events to send to the server!'''<br />
:: Casper needs to debug that. Please '''[[CasperVend_2/Getting_Help#2.29_When_Casper_is_offline:_By_IM-to-Webform_.28Preferred.29 | file a ticket]]''' and leave the orb out where Casper can access it.<br />
<br />
= <span style="color:#00528c">'''Troubleshooting / FAQ'''</span> =<br />
:'''Q. I'm seeing (one or more of) my managers get removed from the orb, but when I list the admins, they're still showing on the orb's list.'''<br />
::'''A.''' CasperSafe clears the list and re-adds them each time it is reset - this is part of the reset process. It is supposed to silence these messages, but sometimes (due to grid things) the messages are processed out of sequence and the remove message is processed before the silence message.</div>24607dde-d704-4db7-afa0-d9edc17c926chttps://wiki.casperdns.com/index.php?title=CasperSafe_Security_Orb&diff=14733CasperSafe Security Orb2021-07-01T21:39:21Z<p>24607dde-d704-4db7-afa0-d9edc17c926c: /* Limitations */</p>
<hr />
<div>{|align=right<br />
|__TOC__<br />
|}<br />
<br />
{{Warning|Orb not ejecting? Please see the [[#Checklist_for_Automatically_Ejecting_Avatars|Checklist for Automatically Ejecting Avatars]], particularly the "Disallow by default" option. This is the most common support query for CasperSafe.}}<br />
<br />
= <span style="color:#00528c">'''About CasperSafe'''</span> =<br />
<br />
CasperSafe is a high-tech security and visitor tracking system. Its features include: <br />
<br />
* Self-contained configuration - no notecards<br />
* Fewer scripts than competing products - 4 instead of 11-13 scripts<br />
* CasperLet Support<br />
* Visitor Tracking option<br />
* Region-wide operation<br />
* Capable of monitoring many parcels at once<br />
<br />
{{Information|Depending on your viewer configuration (fonts, UI size, etc.) the length of the option names may not be identical to what's shown here. Popup menus shown here are from Viewer 3.}}<br />
<br />
= <span style="color:#00528c">'''What's in the Box?'''</span> =<br />
The following named items are in the shipping crate: <br />
:: CasperSafe Enforcer<br />
:: CasperSafe Parcel Link Tool<br />
:: CasperSafe Psychic Link Script (Read the instructions!) <br />
:: CasperSafe Security Orb<br />
<br />
Along with a landmark to the CasperTech store.<br />
<br />
= <span style="color:#00528c">'''What's with the 'war is peace' stuff?'''</span> =<br />
<br />
The orb has been themed in several ways with tongue-in-cheek references to George Orwell's 1984, a novel about totalitarian control, monitoring and mind control. It's not a political statement, just a cultural reference.<br />
<br />
= <span style="color:#00528c">'''Quick Setup Steps'''</span> =<br />
:# Rez the shipping crate and unpack<br />
:# Rez out the CasperSafe Security Orb<br />
:# '''[[CasperSafe_Security_Orb#Add_Areas | Add areas]]''' and/or '''[[CasperSafe_Security_Orb#Link_to_Rental_Unit | link to rental unit]]'''<br />
:# Rez (and deed if necessary) the '''[[CasperSafe_Security_Orb#CasperSafe_Enforcer | Enforcer unit]]'''<br />
:# Add people to appropriate '''[[CasperSafe_Security_Orb#Access_Levels | access lists]]'''<br />
:# Arm the orb<br />
<br />
See the sections below for explanations of all the options.<br />
<br />
= <span style="color:#00528c">'''Configuration Tips'''</span> =<br />
<br />
CasperSafe will save its configuration on the server. Like CasperLet and SimpleSit, this is saves the information against the UUID of the device, barring a complete script reset (which makes it forget everything) or shift-drag-copy (the copy that is left behind has both reset the script AND has a new UUID and thus no old configuration.) <br />
<br />
:* Takes about 20-30 seconds to save configuration changes. <br />
:* Configuration is kept when you "Take a copy" '''then''' Rez the copy<br />
:* Configuration is '''NOT''' kept when you shift > drag > copy (this resets the script) <br />
:* Like CasperLet, the script tracks the UUID of the device. New device = new UUID, thus shift > drag > copy = New device and new UUID. <br />
:* Information will NOT transfer between two unrelated or different version orbs. (This would be a hassle for landlords, where different orbs are expected to have different individual configurations depending on the renter.)<br />
:* When used with CasperLet, the owner and any CasperLet managers are automatically admins<br />
:* When used with CasperLet, the primary tenant + additional subtenants on that rental are added automatically to the SUBADMIN access list. <br />
<br />
CasperSafe is '''not''' meant to be configured via the website - while this may make it less convenient, this does ensure that it continues to function despite any website outage.<br />
<br />
=== Checking Version Number ===<br />
----<br />
Because the UpgradeBee does '''NOT''' rename the object, if you wish to verify that your orb(s) have been updated, you will need to edit > contents tab > right-click on one of the scripts > select "Properties" > check the version number in the description field. See the '''[[Current_Versions | versions page]]''' for current version number and changelog information.<br />
<br />
= <span style="color:#00528c">'''Security Settings & Levels'''</span> =<br />
<br />
== '''Access Levels''' ==<br />
<br />
When Admins click into the access menu, they will get the following options: <br />
{| <br />
| [[File:CasperSafe - Access - Main.png|350px|thumb|left|Access main menu - click to see larger version.]]<br />
|}<br />
<br />
When Subadmins click into the access menu, their options will be a little different: <br />
{| <br />
| [[File:CasperSafe_-_Subadmin_-_Access_Version.png|350px|thumb|left|Subadmin version of access menu - click to see larger version.]]<br />
|}<br />
<br />
== '''Access Level Chart''' ==<br />
<br />
{| class="wikitable"<br />
|-<br />
! Main Menu Option<br />
! Guests<br />
! SubAdmins<br />
! Admins<br />
|-<br />
| Areas <br />
| No<br />
| No<br />
| Yes<br />
|-<br />
| Arm / Disarm<br />
| No<br />
| Yes<br />
| Yes<br />
|-<br />
| Lockdown<br />
| No<br />
| Yes<br />
| Yes<br />
|-<br />
| Link / Unlink (rental units)<br />
| No<br />
| No<br />
| Yes<br />
|-<br />
| Access Menu<br />
| No<br />
| Yes (subadmins / guests / ban list)<br />
| Yes<br />
|-<br />
| Options<br />
| No<br />
| No<br />
| Yes<br />
|-<br />
| Visitor Control Panel<br />
| No<br />
| Yes, no sales<br />
| Yes, with sales<br />
|}<br />
<br />
: '''Admins:''' This is the owner, plus any additional designated avatars added to the orb's Admin list. <br />
: '''SubAdmins:''' Usually subadmins are the tenants of a landlord. As a result, they will not have access to the options list or other higher administrative functions of the orb. <br />
: '''Guest:''' This option allows you to add a mostly permanent "whitelist" of allowed guests. Guest level does '''not''' come with menu access to the orb. <br />
: '''Temporary:''' Like the "Guest" level, except that people added to the temporary list are automatically removed after they leave the sim/region. <br />
: '''Banned:''' This option allows you to add to a list of "never allowed" avatars. Anyone on the ban list will automatically be ejected/teleported home (provided they HAVE a home point set...) upon arrival, if ejection is on and an enforcer is out (and properly deeded if necessary.) <br />
<br />
=== Security Notes ===<br />
----<br />
Each CasperSafe can only hold '''one''' set of security options. <br />
<br />
If you need to have different security settings for different areas, then you'll need one orb per set of security settings. <br />
<br />
Yes, you can rez multiple orbs on the same sim/region.<br />
<br />
:* When used with CasperLet, the owner and any CasperLet managers are automatically admins<br />
:* When used with CasperLet, the primary tenant + additional subtenants on that rental are added automatically to the SUBADMIN access list. <br />
:* Two CasperTech support avatars are added to the whitelist to make it easier to provide any needed support: Casper Warden and CasperHelp Resident.<br />
:* Lockdown mode automatically ends when the entire sim is empty of all allowed avatars.<br />
<br />
== '''Warning Times''' ==<br />
Minimum warning time of 10 seconds (default setting of 30 seconds). <br />
<br />
Lockdown mode warning time of explicitly 00 seconds (instantly ejected), regardless of normal warning time setting. Lockdown mode ends automatically when all allowed avatars leave the sim/region. <br />
<br />
If the avatar is explicitly on the orb's ban list "instant eject" .<br />
<br />
=== Ejected without warning? ===<br />
----<br />
CasperSafe '''always''' sends a warning first, before ejecting (when ejecting is properly configured) '''unless''' it is in "lockdown" mode. <br />
<br />
The times a visitor may not see the warning are: <br />
: 1) If they muted the orb<br />
: 2) If what they think was CasperSafe is actually a neighbour's non-CasperTech orb set to the wrong distance. <br />
<br />
Visitors normally receive a notice, either by popup or by local chat, indicating what they were ejected by.<br />
<br />
== '''CasperSafe Enforcer''' ==<br />
<br />
{{Warning|The CasperSafe Enforcer may ask for permission to return objects. Objects will ONLY be returned IF permissions are granted AND the option to return prims is enabled on the CasperSafe Orb. If activated, the orb will return prims belonging to an avatar when they are '''ejected'''. '''BE CAREFUL''' with this option - we accept no responsibility for any damage caused.}}<br />
<br />
This is the widget that actually does the ejecting / teleport home functions. Thus it is required if you actually want to be able to boot avatars out of the protected area - Otherwise CasperSafe operates in "Warning Mode" which basically nags the avatars instead. <br />
<br />
Like the '''[[CasperLet/Prim_Counter#Prim_Counter_Basics | CasperLet Prim Counter]]''', in order to function properly, the Enforcer widget must be owned by the LAND OWNER. If the land is owned by an individual, that individual must REZ the Enforcer widget. If the land is owned by a group, the Enforcer must be REZZED by an individual with the same group tag as the parcel, and they must then DEED the Enforcer to the group. If there are multiple land owners, then you will need one Enforcer per land owner.<br />
<br />
The permissions of the Enforcer widget are copy & transfer so that it can be deeded to the appropriate land owners.<br />
<br />
{{Critical|For security reasons, the enforcer will only respond to CasperSafe orbs belonging to its '''owner''', or in the case of the enforcer being deeded to group, orbs belonging to the either '''the owner or the previous owner''' (because the land owner isn't always the orb owner.) }}<br />
<br />
'''UPDATES:''' The enforcer only needs to be replaced when a new enforcer version goes out.<br />
<br />
=== Using Enforcer On Group Land Where You're Only Renting ===<br />
----<br />
:# Rez the enforcer - this sets a "bit" so that it know you're the original owner<br />
:# Rename it so you can find it in your inventory<br />
:# Pick up the enforcer<br />
:# Pass THAT copy of the enforcer to your landlord, so THEY can rez it out<br />
:# Landlord will need to deed the enforcer to the group (if group owned land)<br />
<br />
Do '''NOT''' pass over a fresh one that you haven't rezzed first, because it will NOT recognize instructions from your CasperSafe orb.<br />
<br />
=== Enforcer Must Stay Rezzed ===<br />
----<br />
The enforcer will not be able to eject avatars if it is only in your inventory, so yes, the enforcer '''must stay rezzed.''' <br />
<br />
=== One Enforcer Per Parcel ===<br />
----<br />
You only need one (1) enforcer '''per parcel''' - see the '''[[CasperLet/Prim_Counter#Sample_Land_Configurations | prim counter]]''' page for rezzing, when when you have to deed. <br />
<br />
The enforcer will turn all black when it is '''properly''' deeded or rezzed - this is normal and does NOT mean it's broken.<br />
<br />
=== Enforcer and Autoreturn ===<br />
----<br />
If you want the enforcer to utilize autoreturn, you must: <br />
<br />
:# Rez the CasperSafe orb '''first'''. <br />
:# Set up the autoreturn options in settings<br />
:# '''Then''' rez and deed the enforcer.<br />
<br />
=== Enforcer, Group Detection, Autreturn and You ===<br />
----<br />
If you are using '''group detection''', it is '''highly recommended''' that you '''do NOT''' use the object return feature, because people will always forget their group tag, and having object return on may result in an individual having their objects returned.<br />
<br />
= '''<span style="color:#00528c">Land Configuration - When Security Is Required</span>''' =<br />
All examples are on a '''per-region''' basis, and the Enforcer is '''ONLY''' required when you need security on an area in a parcel. If you are simply using it for visitor tracking, no enforcer is needed. <br />
<br />
Even if you have multiple CasperSafes on a parcel for different security settings, you only need ONE Enforcer per parcel. <br />
<br />
The CasperSafe Enforcer cannot operate across sim boundaries; you will need to repeat the appropriate steps for each sim/region that you have. <br />
<br />
{| class="wikitable" <br />
|-<br />
! style="white-space: nowrap; background: #33CCFF; border: 2px solid #383838;" | Land Owners On Sim/Region<br />
! style="white-space: nowrap; background: #33CCFF; border: 2px solid #383838;" | Actions To Take With CasperSafe Enforcer<br />
|-<br />
| Shared land, one parcel <br />Owned by YOU<br />
| <br />
# Rez '''one''' CasperSafe Enforcer, on land YOU own<br />
# No deeding required - just rez and wait<br />
# Repeat on each additional sim/region you have<br />
|-<br />
| Shared land, one parcel <br />Owned by ONE other avatar<br />
| <br />
# Transfer the CasperSafe Enforcer to THAT avatar<br />
# THEY must rez out ONE CasperSafe Enforcer on land owned by THEM<br />
# No deeding required - just rez<br />
# Repeat on each additional sim/region you have<br />
|-<br />
| Shared land, one parcel <br />Owned by ONE land group<br />
| <br />
# Rez out ONE CasperSafe Enforcer on land owned by that group<br />
# Right-Click > Edit > "Share with group" > "Deed"<br />
# Repeat on each additional sim/region you have<br />
|-<br />
| Shared land, multiple parcels <br />Some owned by YOU<br />Some by ONE land group<br />
| <br />
# Rez out one CasperSafe Enforcer on EACH group-owned parcel<br />
# Right-Click > Edit > "Share with group" > "Deed"<br />
# Rez out one CasperSafe Enforcer on EACH parcel owned by you<br />
# No deeding required on the land YOU own - just rez<br />
# Repeat on each additional sim/region you have<br />
|-<br />
| Shared land, multiple parcels <br />Owned by MULTIPLE land groups<br />
| <br />
# Rez one CasperSafe Enforcer PER land group, PER parcel<br />
# Right-Click > Edit > "Share with group" > "Deed"<br />
# Repeat on each additional sim/region you have<br />
|}<br />
<br />
= <span style="color:#00528c">'''Monitoring Areas'''</span> =<br />
Avatars are tracked by the area they're in. If an avatar is registered as entering two areas '''at the same time''' that have identical names, the system will end the first visit to avoid duplicates. <br />
<br />
Please ensure each area that is defined has its own unique name to avoid this! <br />
<br />
== Automatic Settings ==<br />
: * When used with CasperLet, the owner and any CasperLet managers are added automatically to the ADMIN access list. <br />
: * When used with CasperLet, the primary tenant + additional subtenants on that rental are added automatically to the SUBADMIN access list. <br />
: * Lockdown mode automatically ends when the sim/region is empty of all allowed avatars.<br />
<br />
=== Note for Skyboxes ===<br />
----<br />
<br />
If you only want to monitor an area NEAR a skybox, set the orb to monitor a '''range''' instead of the parcel. Parcel will assume you want to keep watch over all of the parcel, from "floor to ceiling".<br />
<br />
== Custom Areas ==<br />
'''Custom Areas: Suitable for odd shaped parcels, or a specific square/rectangular size within a parcel - Limited only by available memory'''<br />
<br />
:* Click for menu<br />
:* Select "Areas" <br />
:* Select "Add" <br />
:* Select "Custom" <br />
:* Corner markers will appear<br />
:* Drag the lower marker to the lowest corner of the area you want to monitor<br />
:* Drag the upper marker to the uppermost corner of the area you want to monitor<br />
:* Click one of the markers<br />
:* Select Save<br />
:* Name the area<br />
:* Done! <br />
<br />
If you accidentally manually delete one marker, the corresponding one will self-delete as well.<br />
<br />
==== Custom Area Issues ====<br />
----<br />
:# "Object Entry" '''must be allowed''' for ALL parcels you are dragging custom markers across.<br />
:# Parcels with autoreturn '''must''' give you enough time to do what you need to do before it will send them back. (You can always set autoreturn back to 1 when you're done.) <br />
<br />
Otherwise you'll see things like particles flying completely out of the parcel, and custom area markers/nodes being automatically returned.<br />
<br />
== Custom Range Radius ==<br />
'''Custom Ranges: Number limited only by amount of available memory in the orb.'''<br />
<br />
To set a custom area: <br />
<br />
:* Click the orb<br />
:* Select "Areas" <br />
:* Select "Add" <br />
:* Select "Range" <br />
:* Enter in the detection range, in meters, and click "Send" <br />
:* Enter name of the area, and click "Send" <br />
:* Done!<br />
<br />
Range = Radius. &nbsp;&nbsp;'''''[https://en.wikipedia.org/wiki/Radius What is a radius?]'''''<br />
<br />
== Parcel Link ==<br />
'''Number of Parcels: Limited only by amount of available memory in the orb.'''<br />
<br />
The Parcel Link Tool allows CasperSafe to be paired with one or more parcels. The Parcel Link Tool must be '''used''' on the parcel that will be linked to the CasperSafe orb, and '''ONLY''' by the owner of the orb. (Admins and subadmins cannot add a parcel using the Parcel Link Tool because the Tool is no-transfer.) This may be rezzed on any parcel and moved over, just be sure to allow a minute or two for it to pick up the change in parcels. <br />
<br />
: '''1)''' Rez the CasperSafe Security Orb on the land you want it to monitor<br />
: '''2)''' Rez the "Parcel Link Tool" - You will get these messages in local chat: <br />
Touch me to pair this parcel with your CasperSafe orb. <br />
Make sure you have started pairing on the orb by choosing AREA -> ADD -> PARCEL, first.<br />
I'm now over parcel ''((parcel name as seen in "about land" floater))''. Touch to register with a CasperSafe Orb.<br />
: '''3)''' On the CasperSafe orb, click for the popup menu<br />
: '''4)''' Select "Areas" <br />
: '''5)''' Select "Add" <br />
: '''5)''' Select "Parcel" <br />
: '''6)''' Then click the Parcel Link Tool. You'll see the following messages in local chat: <br />
OK. Trying to find a CasperSafe orb, please stand by.<br />
Alright, all done!<br />
Pairing process ended.<br />
: '''7)''' The Parcel Link Tool will self-delete when the parcel pairing process is completed. <br />
<br />
Pairing process usually takes 1-2 minutes, but may be longer if the region is heavily lagged.<br />
<br />
== Rental Unit Pairing ==<br />
=== '''Ownership''' ===<br />
----<br />
Rental unit AND the CasperSafe orb '''must''' be owned by the same avatar. This is for security reasons. (If anyone could do this, then anyone could control your security orb without your knowledge or permission.) <br />
<br />
=== '''Pairing Process''' ===<br />
----<br />
<br />
'''Pairing limit: 1 rental unit per orb'''<br />
<br />
'''NOTE:''' CasperSafe may be paired with only ONE rental unit. If you have multiple rental units out, AND you want to pair CasperSafe to the units, you'll need one CasperSafe per unit. <br />
<br />
: '''1)''' Rez CasperSafe Security Orb near the rental unit<br />
: '''2)''' Click CasperSafe for the main menu<br />
{| <br />
| [[File:CasperSafe_-_Main_Menu_-_Unarmed.png|350px|thumb|left|Default main menu - click to see larger version.]]<br />
|}<br />
: '''3)''' Select "LINK". You'll get a popup with instructions: <br />
{| <br />
| [[File:CasperSafe - Link Menu.png|350px|thumb|left|Default main menu - click to see larger version.]]<br />
|}<br />
: '''4)''' Drop the "Psychic Link Script" into the corresponding rental unit<br />
: '''5)''' Watch messages in local chat. If all goes well, you should see: <br />
Okay, let's have a look here..<br />
Ooh, CasperLet! Good choice! Searching for the orb..<br />
Cool! I'm paired with ''((name of rental unit))'' (Key: ''((uuid string))'' )<br />
Pairing process ended. <br />
: '''6)''' The orb will also add the CasperSafe system owner as an ADMIN automatically. <br />
<br />
Pairing process usually takes 1-2 minutes, but may be longer if the region is heavily lagged.<br />
<br />
=== CasperLet Manager Auto-Update Timing ===<br />
----<br />
<br />
CasperSafe will automatically pick up changes to CasperLet managers, '''HOWEVER''' it is not instant - It will take time to filter through, and will be the next time the rental unit updates info to/from the server.<br />
<br />
= <span style="color:#00528c">'''Main Menus'''</span> =<br />
<br />
=== Main Menu for Admins ===<br />
----<br />
<br />
By default, when you first rez out CasperSafe, the orb is in the "unarmed" state. When unarmed, the orb automatically runs in "discreet mode" in order to be kinder to region resources. <br />
{| <br />
| [[File:CasperSafe_-_Main_Menu_-_Unarmed.png|350px|thumb|left|Default main menu - click to see larger version.]]<br />
|}<br />
<br />
When you choose to arm the orb, you will also have an extra "lockdown" option, as shown here: <br />
{| <br />
| [[File:CasperSafe - Main Menu - Armed Mode.png |350px|thumb|left|Armed mode - click to see larger version.]]<br />
|}<br />
When CasperSafe is armed, the base menu will also show the option "Lockdown" - this changes the warning time to 10 seconds (reduced from the normal minimum of 20 seconds), and increases the scan frequency in order to detect possible threats more quickly.<br />
<br />
Also, when someone arrives who is not on any of the access lists, admins will get a popup asking them if they want to add the new arrival on a temporary or guest basis, or whether to ban. <br />
<br />
=== Main Menu for SubAdmins ===<br />
----<br />
Subadmins will typically be tenants of a landlord, and will not have administrator access to the higher functions of the security orb; they will only have access to the following menu items: <br />
:* Access list (to add fellow subadmins, guests and temporary guests) <br />
:* Arm/Disarm/Lockdown<br />
:* Visitor stats (if enabled)<br />
<br />
=== About Lockdown mode===<br />
----<br />
If the orb is currently '''in''' "lockdown" mode, the lockdown option will change to "stand down". <br />
<br />
This automatically disables itself when everyone ON the access list has left the sim/region - there is no time limit beyond that. <br />
<br />
Lockdown mode changes the operation to instant eject (from the normal minimum of 10 seconds), and uses slightly more script time than normal operation (see '''[[CasperSafe_Security_Orb#Script_Times | Script Times]]''' for details) in order to detect possible intrusions faster.<br />
<br />
= <span style="color:#00528c">'''Security Menus'''</span> =<br />
<br />
=== '''Configuration Options Menus''' ===<br />
----<br />
These are the default settings for the options menu, as it ships from CasperTech: <br />
{| <br />
| [[File:CS_Config_Options_Page_1.png|350px|thumb|left|Default Options page 1 - click to see larger version.]] | [[File:CS_Config_Options_Page_2.png|350px|thumb|left|Default Options page 2- click to see larger version.]]<br />
|}<br />
<br />
== '''Configuration Options Explanations''' ==<br />
<br />
{| class="wikitable"<br />
|-<br />
! Options Items<br />
! What it does<br />
|-<br />
| Floating Text<br />
| This turns the radar on and off. Having the radar on will use more script time and processing. <br />
|-<br />
| Disallow by default<br />
| When on, this will eject anyone who's not on the access list. <br />
|-<br />
| Discreet mode<br />
| When on, this slows down the timers to reduce lag. It won't be as responsive, but it will be kinder to region resources. <br />
|-<br />
| Eject from parcel <br />
| When on, this will eject unwanted visitors after the warning period has ended. <br />
|-<br />
| Teleport Home<br />
| When on, this will teleport unwanted visitors to their home point. <br />
|-<br />
| Add to parcel ban list<br />
| When on, this will add ejected avatars to the parcel's land ban list (not the ban list in the orb). <br />
|-<br />
| Warning Time<br />
| This controls how long the avatar can stay before being ejected, if eject mode is on. In "Warning mode" (which is the default, if there is no Enforcer present and/or properly deeded) this is how long before CasperSafe sends another warning to the intruding avatar. The shipped default is 30 seconds, and may be reduced to 10 seconds for normal operation. When in lockdown mode, there is no warning time. <br />
|-<br />
| Age Limit<br />
| When on, you configure the minimum number of days of account age before avatars are allowed in to the protected area. <br />
|-<br />
| Script Limit<br />
| When on, you configure the maximum amount of scripts an avatar may be wearing/using before they are allowed in to the protected area. <br />
|-<br />
| Visitor Tracking<br />
| When on, this tracks visitors and sends visitor data to the CasperTech website. Visitors cannot (currently) be filtered by admin/subadmin/guest levels; access list data is not sent to the website. You must have an '''[[CasperSafe_Security_Orb#Monitoring_Areas | area defined]]''' before tracking will actually take place. (The orb needs to know where to keep watch.) <br />
|-<br />
| Group members are guests<br />
| When on, allows members of the group the orb is rezzed under into the protected area. "Guest" access does not include any part of orb menus. <br />
|-<br />
| Group members are subadmins<br />
| When on, allows members of the group the orb is rezzed under both into the protected area '''and''' gives them subadmin access to the orb itself. <br />
|-<br />
| Limit detection to current parcel<br />
| When on, this limits detection ranges to within the borders of the parcel the orb is rezzed on. This prevents things like the orb's ejecting/banning from affecting users on other (unrelated) parcels. <br />
|-<br />
| Return prims when ejected<br />
| When on, uses the scripted prim autoreturn feature. This is not recommended in combination with group detection, because people often forget their group tag when they try to rez objects. <br />
|-<br />
| Don't send notifications to admins <br />
| When on, this prevents the orb from sending notifications to users on the "Admin" access level. By default, all messages are delivered via llRegionSay to prevent IM's from capping while you are offline. (If IM notifications are prefered, there is an optional script in the orb's shipping crate that will do this.) <br />
|-<br />
| Don't send notifications to subadmins<br />
| When on, this prevents the orb from sending notifications to users on the "SubAdmin" access level. By default, all messages are delivered via llRegionSay to prevent IM's from capping while you are offline. (If IM notifications are prefered, there is an optional script in the orb's shipping crate that will do this.)<br />
|-<br />
| Send notifications to guests<br />
| When on, this will send notifications to users on the "Guest" access level. By default they don't receive notifications. <br />
|-<br />
| No-Fly Zone<br />
| When on, the flying avatar is warned. If "Eject" is on, then the user is ejected from the area. If "Teleport Home" is on, then the user is teleported home. There is no height limit on flight detection. <br />
|-<br />
| Render Weight Limit<br />
| When on, you set the maximum avatar complexity that individual avatars should be at. Users above that point will be warned. If "Eject" is on, then the user is ejected from the area. If "Teleport Home" is on, then the user is teleported home. <br />
|}<br />
<br />
=== Memory Limits ===<br />
----<br />
Data about names for Admin/Subadmin/Guest lists are stored IN the device. Consequently every name that's added will cause the available memory to decrease, and it will give you a local chat message indicating how much memory is left. Once the available memory gets below a certain point (somewhere around 300 names), the orb will crash - so it's up to you to keep an eye on how much memory is being used. <br />
<br />
You CAN rez multiple orbs if you are getting low in memory on the first one.<br />
<br />
= <span style="color:#00528c">'''Render Weight'''</span> =<br />
<br />
The CasperSafe orb has the ability to eject avatars if their render weight (ARC) is too high. However, please be aware that:<br />
<br />
* It is '''not the same thing''' as avatar complexity, but represents the same thing.<br />
* It has a maximum value of 500,000. If you set your limit higher than this, it'll have no effect.<br />
* A render weight of 500,000 is '''roughly''' equivalent to an avatar complexity of 1 million.<br />
* Render weight is calculated by viewers, not the simulator, so it will only work if there are other people nearby.<br />
<br />
Please understand that this is not a predictable or reliable figure, it can vary based on many different factors, and can suffer from random "surges" with apparently no cause. For this reason, we '''do not recommend''' that you enforce a render weight limit. However, the option is there if you require it.<br />
<br />
We've '''[https://jira.secondlife.com/browse/BUG-100791 opened a Jira ticket]''' to request script access to avatar complexity. Vote if you want this feature!<br />
<br />
= <span style="color:#00528c">'''Checklist for Automatically Ejecting Avatars '''</span> =<br />
# Is the Enforcer rezzed out by the land owner? <br />
# Is the enforcer ON the parcel? <br />
# If it is group land, is the Enforcer deeded to the group? <br />
# Is it multiple parcels - and is there one Enforcer PER PARCEL? <br />
# Did you configure an area? (The orb needs to know where to kick avatars FROM...) <br />
# Under Options > Disallow, did you turn "disallow by default" to '''ON'''?<br />
# Is the orb even armed? (You should see "disarm" in the popup menu if it IS armed) <br />
# Has the avatar to be ejected been standing still BEFORE you turned on "disallow by default"? Once the avatar moves, they will be seen and ejected. If they stand still and '''don't''' move, they won't be ejected yet. <br />
# Are you using '''only''' the "teleport home" option? (SL limitation: If the avatar does NOT have a home point set, or the home point no longer exists, the avatar cannot be "sent home".) <br />
<br />
=== Group Tag Issues ===<br />
----<br />
If you have the CasperSafe set to only allow group members, your group members '''MUST ALREADY''' be wearing the group tag when they teleport in. CasperSafe will not recognize if they change tags once they arrive - they'll have to tp out then back to get the orb to see the proper group.<br />
<br />
= <span style="color:#00528c">'''Visitor Tracking '''</span> =<br />
<br />
:* Visitor tracking turns ON or OFF using the options menu (so only Admins may turn this on or off.) <br />
:* Visitor data WILL be sent to CasperTech servers when turned on.<br />
:* When visitor tracking is enabled, the "VISITORS" button will change to "CNTRL PANEL" - click the control panel button to get a link for the web-based visitor stats.<br />
:* You must also '''[[CasperSafe_Security_Orb#Monitoring_Areas | define an area]]''' for the tracking to monitor before visitor tracking will actually take place<br />
:* Visitor tracking does '''not''' require land ownership. You can rent in a mall and still track your mall store visitors.<br />
<br />
=== Missing or Ghosted Visitors ===<br />
----<br />
Every time an avatar enters or leaves an area (and visitor tracking is turned on), the orb must send a message to CasperPanel to let it know. It is expected that - from time to time - one of these message may be lost/dropped, which will either cause a missing visitor, or a visitor remaining visible who has really already left. <br />
<br />
This is normal and expected, from time to time, however it shouldn't happen too often. If you are experiencing this problem very often, please contact '''[[CasperVend_2/Getting_Help#2.29_When_Casper_is_offline:_By_IM-to-Webform | CasperTech support]]''' since there may be something wrong that we need to look at. <br />
<br />
You can fix this by resetting your orb. Your "current visitors" list will also be cleared when the region restarts.<br />
<br />
= <span style="color:#00528c">'''CasperVend and CasperSafe'''</span> =<br />
There is NO linking process required to hook up CasperSafe with CasperVend - this is automatic behind the scenes. If you have visitor list enabled, you will see icons that represent repeat visits, and whether they bought something on that visit. <br />
<br />
= <span style="color:#00528c">'''Customising Your Orb'''</span> =<br />
The default CasperSafe Orb object has 1 prim and 2 faces: <br />
:* The main decorative texture with triangular shapes is face #0<br />
:* The "war is peace" strip is face #1<br />
:* The orb does '''NOT''' check for prim creator - you can use any object to put the scripts in<br />
<br />
=== Textures & Custom Objects ===<br />
----<br />
If you simply don't want the "war is peace" strip to change, there is a notecard in the shipping crate labeled '''DISABLE_TEXTURE_CHANGE''' - simply drop that in the orb's contents, and it will disable further color changes to that strip. <br />
<br />
Alternately, you can rez a simple prim sphere and copy all the contents of the orb to that - an unmodified legacy prim sphere has only face #0. <br />
<br />
'''NOTE:''' Currently, the "Disable texture change" does NOT change the texture animation. Please keep that in mind when making a custom object. <br />
<br />
=== Notifications ===<br />
----<br />
If you want the notifications for your staff to arrive as an object IM instead of a llRegionSay message (so they can potentially reach your staff when they are not in the sim/region) then simply drop the script labeled '''Optional Plugin: Send IMs to staff''' into the orb object, and it will do the rest. <br />
<br />
The optional plugin script is '''open source''' - therefore any changes you make to the script are '''your responsibility''', and are unsupported by CasperTech.<br />
<br />
==== Popup Menu Notifications ====<br />
----<br />
You cannot turn these off at this time, but that functionality is expected to be added in the next release.<br />
<br />
= <span style="color:#00528c">'''API Information'''</span> =<br />
<br />
Per Casper: <br />
'''We haven't yet published the API for CasperSafe.'''<br />
<br />
There is currently no date for when the API will be released. When it is released, it will be inserted into this space. If you are still seeing THIS message, the API information has not been released yet.<br />
<br />
= <span style="color:#00528c">'''Limitations'''</span> =<br />
:* No website configuration<br /> <i>All configuration of the orb itself is done inworld. While it stores minor configuration information online as a backup, it is designed to stay functional even if CasperTech web services have issues.</i><br />
:* Shift-drag-copy loses configuration<br /><i>The new copy will lose all configuration due to a new UUID created which has no record on the database. You may, however, '''take a copy''' of an orb with the desired configuration and rez as many additional copies of that as you please. </i><br />
:* Cannot filter visitor tracking by access level <br /><i>Access level of the avatar is not sent with the visit statistics. </i><br />
:* One orb per set of security settings<br /><i>While the orb can track multiple areas and parcels without an issue, it is only designed to hold ONE set of security settings. You cannot choose to eject people from one area while not ejecting them from another - you'll need multiple orbs. Yes, you can rez multiple orbs on a parcel and a sim/region. </i><br />
:* Land bans limited to the parcel the CasperSafe Enforcer is on<br /><i>llAddToLandBanList only works for the parcel the enforcer is currently on.</i><br />
:* One CasperSafe Enforcer per parcel<br /><i>If the land is group owned, the Enforcer unit will need to be deeded, using the same process as if you were '''[[CasperLet/Prim_Counter#How_to_Properly_Deed_a_Prim_Counter | deeding a prim counter.]]'''</i><br />
:* Deleting areas doesn't remove current visitors<br><i>If you delete an area, any avatars shown as currently visiting the area on the website will not be removed until the next time the orb is reset or the region is restarted.</i><br />
:* No avatar height restrictions<br /><i>CasperSafe does not support any sort of avatar height restriction. Since the introduction of mesh avatars, you can no longer depend on avatar height as being a psuedo-reliable indicator of the avatar's "age". There are many non-child avatars that are also short, and non-human avatars can come in many sizes as well. Height restrictions are therefore irrelevant today, and would eliminate too many '''legitimate''' avatars.</i><br />
:* Cannot manually eject via the orb<br /><i>CasperSafe is only set up to eject in response to an allow prompt.</i><br />
<br />
= <span style="color:#00528c">'''Script Times'''</span> =<br />
<br />
These timings were measured over a 24 hour period, on a relatively quiet full region (Izanagi). Your mileage may vary, and times may be higher on busy sims.<br />
<br />
: UNARMED - 0.003ms<br />
: DISCREET - 0.003ms<br />
: ARMED - 0.004ms<br />
: LOCKDOWN - 0.005ms<br />
: ARMED + RADAR - 0.006ms<br />
: LOCKDOWN + RADAR - 0.007ms<br />
<br />
= <span style="color:#00528c">'''Error Messages'''</span> =<br />
: '''"Script asking non-owner for run time permissions only owner can grant" '''<br />
:: This is only referring to the scripted autoreturn permissions. They can only be granted by an OWNER in the land group. All other functions of the enforcer are unaffected by granting - or not granting - the autoreturn capability.<br />
<br />
:'''ChangeQueue is full! Too many events to send to the server!'''<br />
:: Casper needs to debug that. Please '''[[CasperVend_2/Getting_Help#2.29_When_Casper_is_offline:_By_IM-to-Webform_.28Preferred.29 | file a ticket]]''' and leave the orb out where Casper can access it.<br />
<br />
= <span style="color:#00528c">'''Troubleshooting / FAQ'''</span> =<br />
:'''Q. I'm seeing (one or more of) my managers get removed from the orb, but when I list the admins, they're still showing on the orb's list.'''<br />
::'''A.''' CasperSafe clears the list and re-adds them each time it is reset - this is part of the reset process. It is supposed to silence these messages, but sometimes (due to grid things) the messages are processed out of sequence and the remove message is processed before the silence message.</div>24607dde-d704-4db7-afa0-d9edc17c926chttps://wiki.casperdns.com/index.php?title=CasperSafe_Security_Orb&diff=14732CasperSafe Security Orb2021-07-01T21:38:08Z<p>24607dde-d704-4db7-afa0-d9edc17c926c: /* Configuration Options Explanations */</p>
<hr />
<div>{|align=right<br />
|__TOC__<br />
|}<br />
<br />
{{Warning|Orb not ejecting? Please see the [[#Checklist_for_Automatically_Ejecting_Avatars|Checklist for Automatically Ejecting Avatars]], particularly the "Disallow by default" option. This is the most common support query for CasperSafe.}}<br />
<br />
= <span style="color:#00528c">'''About CasperSafe'''</span> =<br />
<br />
CasperSafe is a high-tech security and visitor tracking system. Its features include: <br />
<br />
* Self-contained configuration - no notecards<br />
* Fewer scripts than competing products - 4 instead of 11-13 scripts<br />
* CasperLet Support<br />
* Visitor Tracking option<br />
* Region-wide operation<br />
* Capable of monitoring many parcels at once<br />
<br />
{{Information|Depending on your viewer configuration (fonts, UI size, etc.) the length of the option names may not be identical to what's shown here. Popup menus shown here are from Viewer 3.}}<br />
<br />
= <span style="color:#00528c">'''What's in the Box?'''</span> =<br />
The following named items are in the shipping crate: <br />
:: CasperSafe Enforcer<br />
:: CasperSafe Parcel Link Tool<br />
:: CasperSafe Psychic Link Script (Read the instructions!) <br />
:: CasperSafe Security Orb<br />
<br />
Along with a landmark to the CasperTech store.<br />
<br />
= <span style="color:#00528c">'''What's with the 'war is peace' stuff?'''</span> =<br />
<br />
The orb has been themed in several ways with tongue-in-cheek references to George Orwell's 1984, a novel about totalitarian control, monitoring and mind control. It's not a political statement, just a cultural reference.<br />
<br />
= <span style="color:#00528c">'''Quick Setup Steps'''</span> =<br />
:# Rez the shipping crate and unpack<br />
:# Rez out the CasperSafe Security Orb<br />
:# '''[[CasperSafe_Security_Orb#Add_Areas | Add areas]]''' and/or '''[[CasperSafe_Security_Orb#Link_to_Rental_Unit | link to rental unit]]'''<br />
:# Rez (and deed if necessary) the '''[[CasperSafe_Security_Orb#CasperSafe_Enforcer | Enforcer unit]]'''<br />
:# Add people to appropriate '''[[CasperSafe_Security_Orb#Access_Levels | access lists]]'''<br />
:# Arm the orb<br />
<br />
See the sections below for explanations of all the options.<br />
<br />
= <span style="color:#00528c">'''Configuration Tips'''</span> =<br />
<br />
CasperSafe will save its configuration on the server. Like CasperLet and SimpleSit, this is saves the information against the UUID of the device, barring a complete script reset (which makes it forget everything) or shift-drag-copy (the copy that is left behind has both reset the script AND has a new UUID and thus no old configuration.) <br />
<br />
:* Takes about 20-30 seconds to save configuration changes. <br />
:* Configuration is kept when you "Take a copy" '''then''' Rez the copy<br />
:* Configuration is '''NOT''' kept when you shift > drag > copy (this resets the script) <br />
:* Like CasperLet, the script tracks the UUID of the device. New device = new UUID, thus shift > drag > copy = New device and new UUID. <br />
:* Information will NOT transfer between two unrelated or different version orbs. (This would be a hassle for landlords, where different orbs are expected to have different individual configurations depending on the renter.)<br />
:* When used with CasperLet, the owner and any CasperLet managers are automatically admins<br />
:* When used with CasperLet, the primary tenant + additional subtenants on that rental are added automatically to the SUBADMIN access list. <br />
<br />
CasperSafe is '''not''' meant to be configured via the website - while this may make it less convenient, this does ensure that it continues to function despite any website outage.<br />
<br />
=== Checking Version Number ===<br />
----<br />
Because the UpgradeBee does '''NOT''' rename the object, if you wish to verify that your orb(s) have been updated, you will need to edit > contents tab > right-click on one of the scripts > select "Properties" > check the version number in the description field. See the '''[[Current_Versions | versions page]]''' for current version number and changelog information.<br />
<br />
= <span style="color:#00528c">'''Security Settings & Levels'''</span> =<br />
<br />
== '''Access Levels''' ==<br />
<br />
When Admins click into the access menu, they will get the following options: <br />
{| <br />
| [[File:CasperSafe - Access - Main.png|350px|thumb|left|Access main menu - click to see larger version.]]<br />
|}<br />
<br />
When Subadmins click into the access menu, their options will be a little different: <br />
{| <br />
| [[File:CasperSafe_-_Subadmin_-_Access_Version.png|350px|thumb|left|Subadmin version of access menu - click to see larger version.]]<br />
|}<br />
<br />
== '''Access Level Chart''' ==<br />
<br />
{| class="wikitable"<br />
|-<br />
! Main Menu Option<br />
! Guests<br />
! SubAdmins<br />
! Admins<br />
|-<br />
| Areas <br />
| No<br />
| No<br />
| Yes<br />
|-<br />
| Arm / Disarm<br />
| No<br />
| Yes<br />
| Yes<br />
|-<br />
| Lockdown<br />
| No<br />
| Yes<br />
| Yes<br />
|-<br />
| Link / Unlink (rental units)<br />
| No<br />
| No<br />
| Yes<br />
|-<br />
| Access Menu<br />
| No<br />
| Yes (subadmins / guests / ban list)<br />
| Yes<br />
|-<br />
| Options<br />
| No<br />
| No<br />
| Yes<br />
|-<br />
| Visitor Control Panel<br />
| No<br />
| Yes, no sales<br />
| Yes, with sales<br />
|}<br />
<br />
: '''Admins:''' This is the owner, plus any additional designated avatars added to the orb's Admin list. <br />
: '''SubAdmins:''' Usually subadmins are the tenants of a landlord. As a result, they will not have access to the options list or other higher administrative functions of the orb. <br />
: '''Guest:''' This option allows you to add a mostly permanent "whitelist" of allowed guests. Guest level does '''not''' come with menu access to the orb. <br />
: '''Temporary:''' Like the "Guest" level, except that people added to the temporary list are automatically removed after they leave the sim/region. <br />
: '''Banned:''' This option allows you to add to a list of "never allowed" avatars. Anyone on the ban list will automatically be ejected/teleported home (provided they HAVE a home point set...) upon arrival, if ejection is on and an enforcer is out (and properly deeded if necessary.) <br />
<br />
=== Security Notes ===<br />
----<br />
Each CasperSafe can only hold '''one''' set of security options. <br />
<br />
If you need to have different security settings for different areas, then you'll need one orb per set of security settings. <br />
<br />
Yes, you can rez multiple orbs on the same sim/region.<br />
<br />
:* When used with CasperLet, the owner and any CasperLet managers are automatically admins<br />
:* When used with CasperLet, the primary tenant + additional subtenants on that rental are added automatically to the SUBADMIN access list. <br />
:* Two CasperTech support avatars are added to the whitelist to make it easier to provide any needed support: Casper Warden and CasperHelp Resident.<br />
:* Lockdown mode automatically ends when the entire sim is empty of all allowed avatars.<br />
<br />
== '''Warning Times''' ==<br />
Minimum warning time of 10 seconds (default setting of 30 seconds). <br />
<br />
Lockdown mode warning time of explicitly 00 seconds (instantly ejected), regardless of normal warning time setting. Lockdown mode ends automatically when all allowed avatars leave the sim/region. <br />
<br />
If the avatar is explicitly on the orb's ban list "instant eject" .<br />
<br />
=== Ejected without warning? ===<br />
----<br />
CasperSafe '''always''' sends a warning first, before ejecting (when ejecting is properly configured) '''unless''' it is in "lockdown" mode. <br />
<br />
The times a visitor may not see the warning are: <br />
: 1) If they muted the orb<br />
: 2) If what they think was CasperSafe is actually a neighbour's non-CasperTech orb set to the wrong distance. <br />
<br />
Visitors normally receive a notice, either by popup or by local chat, indicating what they were ejected by.<br />
<br />
== '''CasperSafe Enforcer''' ==<br />
<br />
{{Warning|The CasperSafe Enforcer may ask for permission to return objects. Objects will ONLY be returned IF permissions are granted AND the option to return prims is enabled on the CasperSafe Orb. If activated, the orb will return prims belonging to an avatar when they are '''ejected'''. '''BE CAREFUL''' with this option - we accept no responsibility for any damage caused.}}<br />
<br />
This is the widget that actually does the ejecting / teleport home functions. Thus it is required if you actually want to be able to boot avatars out of the protected area - Otherwise CasperSafe operates in "Warning Mode" which basically nags the avatars instead. <br />
<br />
Like the '''[[CasperLet/Prim_Counter#Prim_Counter_Basics | CasperLet Prim Counter]]''', in order to function properly, the Enforcer widget must be owned by the LAND OWNER. If the land is owned by an individual, that individual must REZ the Enforcer widget. If the land is owned by a group, the Enforcer must be REZZED by an individual with the same group tag as the parcel, and they must then DEED the Enforcer to the group. If there are multiple land owners, then you will need one Enforcer per land owner.<br />
<br />
The permissions of the Enforcer widget are copy & transfer so that it can be deeded to the appropriate land owners.<br />
<br />
{{Critical|For security reasons, the enforcer will only respond to CasperSafe orbs belonging to its '''owner''', or in the case of the enforcer being deeded to group, orbs belonging to the either '''the owner or the previous owner''' (because the land owner isn't always the orb owner.) }}<br />
<br />
'''UPDATES:''' The enforcer only needs to be replaced when a new enforcer version goes out.<br />
<br />
=== Using Enforcer On Group Land Where You're Only Renting ===<br />
----<br />
:# Rez the enforcer - this sets a "bit" so that it know you're the original owner<br />
:# Rename it so you can find it in your inventory<br />
:# Pick up the enforcer<br />
:# Pass THAT copy of the enforcer to your landlord, so THEY can rez it out<br />
:# Landlord will need to deed the enforcer to the group (if group owned land)<br />
<br />
Do '''NOT''' pass over a fresh one that you haven't rezzed first, because it will NOT recognize instructions from your CasperSafe orb.<br />
<br />
=== Enforcer Must Stay Rezzed ===<br />
----<br />
The enforcer will not be able to eject avatars if it is only in your inventory, so yes, the enforcer '''must stay rezzed.''' <br />
<br />
=== One Enforcer Per Parcel ===<br />
----<br />
You only need one (1) enforcer '''per parcel''' - see the '''[[CasperLet/Prim_Counter#Sample_Land_Configurations | prim counter]]''' page for rezzing, when when you have to deed. <br />
<br />
The enforcer will turn all black when it is '''properly''' deeded or rezzed - this is normal and does NOT mean it's broken.<br />
<br />
=== Enforcer and Autoreturn ===<br />
----<br />
If you want the enforcer to utilize autoreturn, you must: <br />
<br />
:# Rez the CasperSafe orb '''first'''. <br />
:# Set up the autoreturn options in settings<br />
:# '''Then''' rez and deed the enforcer.<br />
<br />
=== Enforcer, Group Detection, Autreturn and You ===<br />
----<br />
If you are using '''group detection''', it is '''highly recommended''' that you '''do NOT''' use the object return feature, because people will always forget their group tag, and having object return on may result in an individual having their objects returned.<br />
<br />
= '''<span style="color:#00528c">Land Configuration - When Security Is Required</span>''' =<br />
All examples are on a '''per-region''' basis, and the Enforcer is '''ONLY''' required when you need security on an area in a parcel. If you are simply using it for visitor tracking, no enforcer is needed. <br />
<br />
Even if you have multiple CasperSafes on a parcel for different security settings, you only need ONE Enforcer per parcel. <br />
<br />
The CasperSafe Enforcer cannot operate across sim boundaries; you will need to repeat the appropriate steps for each sim/region that you have. <br />
<br />
{| class="wikitable" <br />
|-<br />
! style="white-space: nowrap; background: #33CCFF; border: 2px solid #383838;" | Land Owners On Sim/Region<br />
! style="white-space: nowrap; background: #33CCFF; border: 2px solid #383838;" | Actions To Take With CasperSafe Enforcer<br />
|-<br />
| Shared land, one parcel <br />Owned by YOU<br />
| <br />
# Rez '''one''' CasperSafe Enforcer, on land YOU own<br />
# No deeding required - just rez and wait<br />
# Repeat on each additional sim/region you have<br />
|-<br />
| Shared land, one parcel <br />Owned by ONE other avatar<br />
| <br />
# Transfer the CasperSafe Enforcer to THAT avatar<br />
# THEY must rez out ONE CasperSafe Enforcer on land owned by THEM<br />
# No deeding required - just rez<br />
# Repeat on each additional sim/region you have<br />
|-<br />
| Shared land, one parcel <br />Owned by ONE land group<br />
| <br />
# Rez out ONE CasperSafe Enforcer on land owned by that group<br />
# Right-Click > Edit > "Share with group" > "Deed"<br />
# Repeat on each additional sim/region you have<br />
|-<br />
| Shared land, multiple parcels <br />Some owned by YOU<br />Some by ONE land group<br />
| <br />
# Rez out one CasperSafe Enforcer on EACH group-owned parcel<br />
# Right-Click > Edit > "Share with group" > "Deed"<br />
# Rez out one CasperSafe Enforcer on EACH parcel owned by you<br />
# No deeding required on the land YOU own - just rez<br />
# Repeat on each additional sim/region you have<br />
|-<br />
| Shared land, multiple parcels <br />Owned by MULTIPLE land groups<br />
| <br />
# Rez one CasperSafe Enforcer PER land group, PER parcel<br />
# Right-Click > Edit > "Share with group" > "Deed"<br />
# Repeat on each additional sim/region you have<br />
|}<br />
<br />
= <span style="color:#00528c">'''Monitoring Areas'''</span> =<br />
Avatars are tracked by the area they're in. If an avatar is registered as entering two areas '''at the same time''' that have identical names, the system will end the first visit to avoid duplicates. <br />
<br />
Please ensure each area that is defined has its own unique name to avoid this! <br />
<br />
== Automatic Settings ==<br />
: * When used with CasperLet, the owner and any CasperLet managers are added automatically to the ADMIN access list. <br />
: * When used with CasperLet, the primary tenant + additional subtenants on that rental are added automatically to the SUBADMIN access list. <br />
: * Lockdown mode automatically ends when the sim/region is empty of all allowed avatars.<br />
<br />
=== Note for Skyboxes ===<br />
----<br />
<br />
If you only want to monitor an area NEAR a skybox, set the orb to monitor a '''range''' instead of the parcel. Parcel will assume you want to keep watch over all of the parcel, from "floor to ceiling".<br />
<br />
== Custom Areas ==<br />
'''Custom Areas: Suitable for odd shaped parcels, or a specific square/rectangular size within a parcel - Limited only by available memory'''<br />
<br />
:* Click for menu<br />
:* Select "Areas" <br />
:* Select "Add" <br />
:* Select "Custom" <br />
:* Corner markers will appear<br />
:* Drag the lower marker to the lowest corner of the area you want to monitor<br />
:* Drag the upper marker to the uppermost corner of the area you want to monitor<br />
:* Click one of the markers<br />
:* Select Save<br />
:* Name the area<br />
:* Done! <br />
<br />
If you accidentally manually delete one marker, the corresponding one will self-delete as well.<br />
<br />
==== Custom Area Issues ====<br />
----<br />
:# "Object Entry" '''must be allowed''' for ALL parcels you are dragging custom markers across.<br />
:# Parcels with autoreturn '''must''' give you enough time to do what you need to do before it will send them back. (You can always set autoreturn back to 1 when you're done.) <br />
<br />
Otherwise you'll see things like particles flying completely out of the parcel, and custom area markers/nodes being automatically returned.<br />
<br />
== Custom Range Radius ==<br />
'''Custom Ranges: Number limited only by amount of available memory in the orb.'''<br />
<br />
To set a custom area: <br />
<br />
:* Click the orb<br />
:* Select "Areas" <br />
:* Select "Add" <br />
:* Select "Range" <br />
:* Enter in the detection range, in meters, and click "Send" <br />
:* Enter name of the area, and click "Send" <br />
:* Done!<br />
<br />
Range = Radius. &nbsp;&nbsp;'''''[https://en.wikipedia.org/wiki/Radius What is a radius?]'''''<br />
<br />
== Parcel Link ==<br />
'''Number of Parcels: Limited only by amount of available memory in the orb.'''<br />
<br />
The Parcel Link Tool allows CasperSafe to be paired with one or more parcels. The Parcel Link Tool must be '''used''' on the parcel that will be linked to the CasperSafe orb, and '''ONLY''' by the owner of the orb. (Admins and subadmins cannot add a parcel using the Parcel Link Tool because the Tool is no-transfer.) This may be rezzed on any parcel and moved over, just be sure to allow a minute or two for it to pick up the change in parcels. <br />
<br />
: '''1)''' Rez the CasperSafe Security Orb on the land you want it to monitor<br />
: '''2)''' Rez the "Parcel Link Tool" - You will get these messages in local chat: <br />
Touch me to pair this parcel with your CasperSafe orb. <br />
Make sure you have started pairing on the orb by choosing AREA -> ADD -> PARCEL, first.<br />
I'm now over parcel ''((parcel name as seen in "about land" floater))''. Touch to register with a CasperSafe Orb.<br />
: '''3)''' On the CasperSafe orb, click for the popup menu<br />
: '''4)''' Select "Areas" <br />
: '''5)''' Select "Add" <br />
: '''5)''' Select "Parcel" <br />
: '''6)''' Then click the Parcel Link Tool. You'll see the following messages in local chat: <br />
OK. Trying to find a CasperSafe orb, please stand by.<br />
Alright, all done!<br />
Pairing process ended.<br />
: '''7)''' The Parcel Link Tool will self-delete when the parcel pairing process is completed. <br />
<br />
Pairing process usually takes 1-2 minutes, but may be longer if the region is heavily lagged.<br />
<br />
== Rental Unit Pairing ==<br />
=== '''Ownership''' ===<br />
----<br />
Rental unit AND the CasperSafe orb '''must''' be owned by the same avatar. This is for security reasons. (If anyone could do this, then anyone could control your security orb without your knowledge or permission.) <br />
<br />
=== '''Pairing Process''' ===<br />
----<br />
<br />
'''Pairing limit: 1 rental unit per orb'''<br />
<br />
'''NOTE:''' CasperSafe may be paired with only ONE rental unit. If you have multiple rental units out, AND you want to pair CasperSafe to the units, you'll need one CasperSafe per unit. <br />
<br />
: '''1)''' Rez CasperSafe Security Orb near the rental unit<br />
: '''2)''' Click CasperSafe for the main menu<br />
{| <br />
| [[File:CasperSafe_-_Main_Menu_-_Unarmed.png|350px|thumb|left|Default main menu - click to see larger version.]]<br />
|}<br />
: '''3)''' Select "LINK". You'll get a popup with instructions: <br />
{| <br />
| [[File:CasperSafe - Link Menu.png|350px|thumb|left|Default main menu - click to see larger version.]]<br />
|}<br />
: '''4)''' Drop the "Psychic Link Script" into the corresponding rental unit<br />
: '''5)''' Watch messages in local chat. If all goes well, you should see: <br />
Okay, let's have a look here..<br />
Ooh, CasperLet! Good choice! Searching for the orb..<br />
Cool! I'm paired with ''((name of rental unit))'' (Key: ''((uuid string))'' )<br />
Pairing process ended. <br />
: '''6)''' The orb will also add the CasperSafe system owner as an ADMIN automatically. <br />
<br />
Pairing process usually takes 1-2 minutes, but may be longer if the region is heavily lagged.<br />
<br />
=== CasperLet Manager Auto-Update Timing ===<br />
----<br />
<br />
CasperSafe will automatically pick up changes to CasperLet managers, '''HOWEVER''' it is not instant - It will take time to filter through, and will be the next time the rental unit updates info to/from the server.<br />
<br />
= <span style="color:#00528c">'''Main Menus'''</span> =<br />
<br />
=== Main Menu for Admins ===<br />
----<br />
<br />
By default, when you first rez out CasperSafe, the orb is in the "unarmed" state. When unarmed, the orb automatically runs in "discreet mode" in order to be kinder to region resources. <br />
{| <br />
| [[File:CasperSafe_-_Main_Menu_-_Unarmed.png|350px|thumb|left|Default main menu - click to see larger version.]]<br />
|}<br />
<br />
When you choose to arm the orb, you will also have an extra "lockdown" option, as shown here: <br />
{| <br />
| [[File:CasperSafe - Main Menu - Armed Mode.png |350px|thumb|left|Armed mode - click to see larger version.]]<br />
|}<br />
When CasperSafe is armed, the base menu will also show the option "Lockdown" - this changes the warning time to 10 seconds (reduced from the normal minimum of 20 seconds), and increases the scan frequency in order to detect possible threats more quickly.<br />
<br />
Also, when someone arrives who is not on any of the access lists, admins will get a popup asking them if they want to add the new arrival on a temporary or guest basis, or whether to ban. <br />
<br />
=== Main Menu for SubAdmins ===<br />
----<br />
Subadmins will typically be tenants of a landlord, and will not have administrator access to the higher functions of the security orb; they will only have access to the following menu items: <br />
:* Access list (to add fellow subadmins, guests and temporary guests) <br />
:* Arm/Disarm/Lockdown<br />
:* Visitor stats (if enabled)<br />
<br />
=== About Lockdown mode===<br />
----<br />
If the orb is currently '''in''' "lockdown" mode, the lockdown option will change to "stand down". <br />
<br />
This automatically disables itself when everyone ON the access list has left the sim/region - there is no time limit beyond that. <br />
<br />
Lockdown mode changes the operation to instant eject (from the normal minimum of 10 seconds), and uses slightly more script time than normal operation (see '''[[CasperSafe_Security_Orb#Script_Times | Script Times]]''' for details) in order to detect possible intrusions faster.<br />
<br />
= <span style="color:#00528c">'''Security Menus'''</span> =<br />
<br />
=== '''Configuration Options Menus''' ===<br />
----<br />
These are the default settings for the options menu, as it ships from CasperTech: <br />
{| <br />
| [[File:CS_Config_Options_Page_1.png|350px|thumb|left|Default Options page 1 - click to see larger version.]] | [[File:CS_Config_Options_Page_2.png|350px|thumb|left|Default Options page 2- click to see larger version.]]<br />
|}<br />
<br />
== '''Configuration Options Explanations''' ==<br />
<br />
{| class="wikitable"<br />
|-<br />
! Options Items<br />
! What it does<br />
|-<br />
| Floating Text<br />
| This turns the radar on and off. Having the radar on will use more script time and processing. <br />
|-<br />
| Disallow by default<br />
| When on, this will eject anyone who's not on the access list. <br />
|-<br />
| Discreet mode<br />
| When on, this slows down the timers to reduce lag. It won't be as responsive, but it will be kinder to region resources. <br />
|-<br />
| Eject from parcel <br />
| When on, this will eject unwanted visitors after the warning period has ended. <br />
|-<br />
| Teleport Home<br />
| When on, this will teleport unwanted visitors to their home point. <br />
|-<br />
| Add to parcel ban list<br />
| When on, this will add ejected avatars to the parcel's land ban list (not the ban list in the orb). <br />
|-<br />
| Warning Time<br />
| This controls how long the avatar can stay before being ejected, if eject mode is on. In "Warning mode" (which is the default, if there is no Enforcer present and/or properly deeded) this is how long before CasperSafe sends another warning to the intruding avatar. The shipped default is 30 seconds, and may be reduced to 10 seconds for normal operation. When in lockdown mode, there is no warning time. <br />
|-<br />
| Age Limit<br />
| When on, you configure the minimum number of days of account age before avatars are allowed in to the protected area. <br />
|-<br />
| Script Limit<br />
| When on, you configure the maximum amount of scripts an avatar may be wearing/using before they are allowed in to the protected area. <br />
|-<br />
| Visitor Tracking<br />
| When on, this tracks visitors and sends visitor data to the CasperTech website. Visitors cannot (currently) be filtered by admin/subadmin/guest levels; access list data is not sent to the website. You must have an '''[[CasperSafe_Security_Orb#Monitoring_Areas | area defined]]''' before tracking will actually take place. (The orb needs to know where to keep watch.) <br />
|-<br />
| Group members are guests<br />
| When on, allows members of the group the orb is rezzed under into the protected area. "Guest" access does not include any part of orb menus. <br />
|-<br />
| Group members are subadmins<br />
| When on, allows members of the group the orb is rezzed under both into the protected area '''and''' gives them subadmin access to the orb itself. <br />
|-<br />
| Limit detection to current parcel<br />
| When on, this limits detection ranges to within the borders of the parcel the orb is rezzed on. This prevents things like the orb's ejecting/banning from affecting users on other (unrelated) parcels. <br />
|-<br />
| Return prims when ejected<br />
| When on, uses the scripted prim autoreturn feature. This is not recommended in combination with group detection, because people often forget their group tag when they try to rez objects. <br />
|-<br />
| Don't send notifications to admins <br />
| When on, this prevents the orb from sending notifications to users on the "Admin" access level. By default, all messages are delivered via llRegionSay to prevent IM's from capping while you are offline. (If IM notifications are prefered, there is an optional script in the orb's shipping crate that will do this.) <br />
|-<br />
| Don't send notifications to subadmins<br />
| When on, this prevents the orb from sending notifications to users on the "SubAdmin" access level. By default, all messages are delivered via llRegionSay to prevent IM's from capping while you are offline. (If IM notifications are prefered, there is an optional script in the orb's shipping crate that will do this.)<br />
|-<br />
| Send notifications to guests<br />
| When on, this will send notifications to users on the "Guest" access level. By default they don't receive notifications. <br />
|-<br />
| No-Fly Zone<br />
| When on, the flying avatar is warned. If "Eject" is on, then the user is ejected from the area. If "Teleport Home" is on, then the user is teleported home. There is no height limit on flight detection. <br />
|-<br />
| Render Weight Limit<br />
| When on, you set the maximum avatar complexity that individual avatars should be at. Users above that point will be warned. If "Eject" is on, then the user is ejected from the area. If "Teleport Home" is on, then the user is teleported home. <br />
|}<br />
<br />
=== Memory Limits ===<br />
----<br />
Data about names for Admin/Subadmin/Guest lists are stored IN the device. Consequently every name that's added will cause the available memory to decrease, and it will give you a local chat message indicating how much memory is left. Once the available memory gets below a certain point (somewhere around 300 names), the orb will crash - so it's up to you to keep an eye on how much memory is being used. <br />
<br />
You CAN rez multiple orbs if you are getting low in memory on the first one.<br />
<br />
= <span style="color:#00528c">'''Render Weight'''</span> =<br />
<br />
The CasperSafe orb has the ability to eject avatars if their render weight (ARC) is too high. However, please be aware that:<br />
<br />
* It is '''not the same thing''' as avatar complexity, but represents the same thing.<br />
* It has a maximum value of 500,000. If you set your limit higher than this, it'll have no effect.<br />
* A render weight of 500,000 is '''roughly''' equivalent to an avatar complexity of 1 million.<br />
* Render weight is calculated by viewers, not the simulator, so it will only work if there are other people nearby.<br />
<br />
Please understand that this is not a predictable or reliable figure, it can vary based on many different factors, and can suffer from random "surges" with apparently no cause. For this reason, we '''do not recommend''' that you enforce a render weight limit. However, the option is there if you require it.<br />
<br />
We've '''[https://jira.secondlife.com/browse/BUG-100791 opened a Jira ticket]''' to request script access to avatar complexity. Vote if you want this feature!<br />
<br />
= <span style="color:#00528c">'''Checklist for Automatically Ejecting Avatars '''</span> =<br />
# Is the Enforcer rezzed out by the land owner? <br />
# Is the enforcer ON the parcel? <br />
# If it is group land, is the Enforcer deeded to the group? <br />
# Is it multiple parcels - and is there one Enforcer PER PARCEL? <br />
# Did you configure an area? (The orb needs to know where to kick avatars FROM...) <br />
# Under Options > Disallow, did you turn "disallow by default" to '''ON'''?<br />
# Is the orb even armed? (You should see "disarm" in the popup menu if it IS armed) <br />
# Has the avatar to be ejected been standing still BEFORE you turned on "disallow by default"? Once the avatar moves, they will be seen and ejected. If they stand still and '''don't''' move, they won't be ejected yet. <br />
# Are you using '''only''' the "teleport home" option? (SL limitation: If the avatar does NOT have a home point set, or the home point no longer exists, the avatar cannot be "sent home".) <br />
<br />
=== Group Tag Issues ===<br />
----<br />
If you have the CasperSafe set to only allow group members, your group members '''MUST ALREADY''' be wearing the group tag when they teleport in. CasperSafe will not recognize if they change tags once they arrive - they'll have to tp out then back to get the orb to see the proper group.<br />
<br />
= <span style="color:#00528c">'''Visitor Tracking '''</span> =<br />
<br />
:* Visitor tracking turns ON or OFF using the options menu (so only Admins may turn this on or off.) <br />
:* Visitor data WILL be sent to CasperTech servers when turned on.<br />
:* When visitor tracking is enabled, the "VISITORS" button will change to "CNTRL PANEL" - click the control panel button to get a link for the web-based visitor stats.<br />
:* You must also '''[[CasperSafe_Security_Orb#Monitoring_Areas | define an area]]''' for the tracking to monitor before visitor tracking will actually take place<br />
:* Visitor tracking does '''not''' require land ownership. You can rent in a mall and still track your mall store visitors.<br />
<br />
=== Missing or Ghosted Visitors ===<br />
----<br />
Every time an avatar enters or leaves an area (and visitor tracking is turned on), the orb must send a message to CasperPanel to let it know. It is expected that - from time to time - one of these message may be lost/dropped, which will either cause a missing visitor, or a visitor remaining visible who has really already left. <br />
<br />
This is normal and expected, from time to time, however it shouldn't happen too often. If you are experiencing this problem very often, please contact '''[[CasperVend_2/Getting_Help#2.29_When_Casper_is_offline:_By_IM-to-Webform | CasperTech support]]''' since there may be something wrong that we need to look at. <br />
<br />
You can fix this by resetting your orb. Your "current visitors" list will also be cleared when the region restarts.<br />
<br />
= <span style="color:#00528c">'''CasperVend and CasperSafe'''</span> =<br />
There is NO linking process required to hook up CasperSafe with CasperVend - this is automatic behind the scenes. If you have visitor list enabled, you will see icons that represent repeat visits, and whether they bought something on that visit. <br />
<br />
= <span style="color:#00528c">'''Customising Your Orb'''</span> =<br />
The default CasperSafe Orb object has 1 prim and 2 faces: <br />
:* The main decorative texture with triangular shapes is face #0<br />
:* The "war is peace" strip is face #1<br />
:* The orb does '''NOT''' check for prim creator - you can use any object to put the scripts in<br />
<br />
=== Textures & Custom Objects ===<br />
----<br />
If you simply don't want the "war is peace" strip to change, there is a notecard in the shipping crate labeled '''DISABLE_TEXTURE_CHANGE''' - simply drop that in the orb's contents, and it will disable further color changes to that strip. <br />
<br />
Alternately, you can rez a simple prim sphere and copy all the contents of the orb to that - an unmodified legacy prim sphere has only face #0. <br />
<br />
'''NOTE:''' Currently, the "Disable texture change" does NOT change the texture animation. Please keep that in mind when making a custom object. <br />
<br />
=== Notifications ===<br />
----<br />
If you want the notifications for your staff to arrive as an object IM instead of a llRegionSay message (so they can potentially reach your staff when they are not in the sim/region) then simply drop the script labeled '''Optional Plugin: Send IMs to staff''' into the orb object, and it will do the rest. <br />
<br />
The optional plugin script is '''open source''' - therefore any changes you make to the script are '''your responsibility''', and are unsupported by CasperTech.<br />
<br />
==== Popup Menu Notifications ====<br />
----<br />
You cannot turn these off at this time, but that functionality is expected to be added in the next release.<br />
<br />
= <span style="color:#00528c">'''API Information'''</span> =<br />
<br />
Per Casper: <br />
'''We haven't yet published the API for CasperSafe.'''<br />
<br />
There is currently no date for when the API will be released. When it is released, it will be inserted into this space. If you are still seeing THIS message, the API information has not been released yet.<br />
<br />
= <span style="color:#00528c">'''Limitations'''</span> =<br />
:* No website configuration<br /> <i>All configuration of the orb itself is done inworld. While it stores minor configuration information online as a backup, it is designed to stay functional even if CasperTech web services have issues.</i><br />
:* Shift-drag-copy loses configuration<br /><i>The new copy will lose all configuration due to a new UUID created which has no record on the database. You may, however, '''take a copy''' of an orb with the desired configuration and rez as many additional copies of that as you please. </i><br />
:* Cannot filter visitor tracking by access level <br /><i>Access level of the avatar is not sent with the visit statistics. </i><br />
:* One orb per set of security settings<br /><i>While the orb can track multiple areas and parcels without an issue, it is only designed to hold ONE set of security settings. You cannot choose to eject people from one area while not ejecting them from another - you'll need multiple orbs. Yes, you can rez multiple orbs on a parcel and a sim/region. </i><br />
:* Land bans limited to the parcel the CasperSafe Enforcer is on<br /><i>llAddToLandBanList only works for the parcel the enforcer is currently on.</i><br />
:* One CasperSafe Enforcer per parcel<br /><i>If the land is group owned, the Enforcer unit will need to be deeded, using the same process as if you were '''[[CasperLet/Prim_Counter#How_to_Properly_Deed_a_Prim_Counter | deeding a prim counter.]]'''</i><br />
:* Deleting areas doesn't remove current visitors<br><i>If you delete an area, any avatars shown as currently visiting the area on the website will not be removed until the next time the orb is reset or the region is restarted.</i><br />
:* No avatar height restrictions<br /><i>CasperSafe does not support any sort of avatar height restriction. Since the introduction of mesh avatars, you can no longer depend on avatar height as being a psuedo-reliable indicator of the avatar's "age". There are many non-child avatars that are also short, and non-human avatars can come in many sizes as well. Height restrictions are therefore irrelevant today, and would eliminate too many '''legitimate''' avatars.</i><br />
:* No instant eject mode<br /><i>CasperSafe is designed to be fair to all. Security devices which are set to less than 10 seconds do not provide ample opportunity for passer-bys to vacate the area voluntarily - for the above reason, we don't support an "instant" eject mode. However, those who are on the "Ban" list '''will''' be ejected instantly.</i><br />
:* Cannot manually eject via the orb<br /><i>CasperSafe is only set up to eject in response to an allow prompt.</i><br />
<br />
= <span style="color:#00528c">'''Script Times'''</span> =<br />
<br />
These timings were measured over a 24 hour period, on a relatively quiet full region (Izanagi). Your mileage may vary, and times may be higher on busy sims.<br />
<br />
: UNARMED - 0.003ms<br />
: DISCREET - 0.003ms<br />
: ARMED - 0.004ms<br />
: LOCKDOWN - 0.005ms<br />
: ARMED + RADAR - 0.006ms<br />
: LOCKDOWN + RADAR - 0.007ms<br />
<br />
= <span style="color:#00528c">'''Error Messages'''</span> =<br />
: '''"Script asking non-owner for run time permissions only owner can grant" '''<br />
:: This is only referring to the scripted autoreturn permissions. They can only be granted by an OWNER in the land group. All other functions of the enforcer are unaffected by granting - or not granting - the autoreturn capability.<br />
<br />
:'''ChangeQueue is full! Too many events to send to the server!'''<br />
:: Casper needs to debug that. Please '''[[CasperVend_2/Getting_Help#2.29_When_Casper_is_offline:_By_IM-to-Webform_.28Preferred.29 | file a ticket]]''' and leave the orb out where Casper can access it.<br />
<br />
= <span style="color:#00528c">'''Troubleshooting / FAQ'''</span> =<br />
:'''Q. I'm seeing (one or more of) my managers get removed from the orb, but when I list the admins, they're still showing on the orb's list.'''<br />
::'''A.''' CasperSafe clears the list and re-adds them each time it is reset - this is part of the reset process. It is supposed to silence these messages, but sometimes (due to grid things) the messages are processed out of sequence and the remove message is processed before the silence message.</div>24607dde-d704-4db7-afa0-d9edc17c926chttps://wiki.casperdns.com/index.php?title=CasperSafe_Security_Orb&diff=14731CasperSafe Security Orb2021-07-01T21:36:59Z<p>24607dde-d704-4db7-afa0-d9edc17c926c: /* About Lockdown mode */</p>
<hr />
<div>{|align=right<br />
|__TOC__<br />
|}<br />
<br />
{{Warning|Orb not ejecting? Please see the [[#Checklist_for_Automatically_Ejecting_Avatars|Checklist for Automatically Ejecting Avatars]], particularly the "Disallow by default" option. This is the most common support query for CasperSafe.}}<br />
<br />
= <span style="color:#00528c">'''About CasperSafe'''</span> =<br />
<br />
CasperSafe is a high-tech security and visitor tracking system. Its features include: <br />
<br />
* Self-contained configuration - no notecards<br />
* Fewer scripts than competing products - 4 instead of 11-13 scripts<br />
* CasperLet Support<br />
* Visitor Tracking option<br />
* Region-wide operation<br />
* Capable of monitoring many parcels at once<br />
<br />
{{Information|Depending on your viewer configuration (fonts, UI size, etc.) the length of the option names may not be identical to what's shown here. Popup menus shown here are from Viewer 3.}}<br />
<br />
= <span style="color:#00528c">'''What's in the Box?'''</span> =<br />
The following named items are in the shipping crate: <br />
:: CasperSafe Enforcer<br />
:: CasperSafe Parcel Link Tool<br />
:: CasperSafe Psychic Link Script (Read the instructions!) <br />
:: CasperSafe Security Orb<br />
<br />
Along with a landmark to the CasperTech store.<br />
<br />
= <span style="color:#00528c">'''What's with the 'war is peace' stuff?'''</span> =<br />
<br />
The orb has been themed in several ways with tongue-in-cheek references to George Orwell's 1984, a novel about totalitarian control, monitoring and mind control. It's not a political statement, just a cultural reference.<br />
<br />
= <span style="color:#00528c">'''Quick Setup Steps'''</span> =<br />
:# Rez the shipping crate and unpack<br />
:# Rez out the CasperSafe Security Orb<br />
:# '''[[CasperSafe_Security_Orb#Add_Areas | Add areas]]''' and/or '''[[CasperSafe_Security_Orb#Link_to_Rental_Unit | link to rental unit]]'''<br />
:# Rez (and deed if necessary) the '''[[CasperSafe_Security_Orb#CasperSafe_Enforcer | Enforcer unit]]'''<br />
:# Add people to appropriate '''[[CasperSafe_Security_Orb#Access_Levels | access lists]]'''<br />
:# Arm the orb<br />
<br />
See the sections below for explanations of all the options.<br />
<br />
= <span style="color:#00528c">'''Configuration Tips'''</span> =<br />
<br />
CasperSafe will save its configuration on the server. Like CasperLet and SimpleSit, this is saves the information against the UUID of the device, barring a complete script reset (which makes it forget everything) or shift-drag-copy (the copy that is left behind has both reset the script AND has a new UUID and thus no old configuration.) <br />
<br />
:* Takes about 20-30 seconds to save configuration changes. <br />
:* Configuration is kept when you "Take a copy" '''then''' Rez the copy<br />
:* Configuration is '''NOT''' kept when you shift > drag > copy (this resets the script) <br />
:* Like CasperLet, the script tracks the UUID of the device. New device = new UUID, thus shift > drag > copy = New device and new UUID. <br />
:* Information will NOT transfer between two unrelated or different version orbs. (This would be a hassle for landlords, where different orbs are expected to have different individual configurations depending on the renter.)<br />
:* When used with CasperLet, the owner and any CasperLet managers are automatically admins<br />
:* When used with CasperLet, the primary tenant + additional subtenants on that rental are added automatically to the SUBADMIN access list. <br />
<br />
CasperSafe is '''not''' meant to be configured via the website - while this may make it less convenient, this does ensure that it continues to function despite any website outage.<br />
<br />
=== Checking Version Number ===<br />
----<br />
Because the UpgradeBee does '''NOT''' rename the object, if you wish to verify that your orb(s) have been updated, you will need to edit > contents tab > right-click on one of the scripts > select "Properties" > check the version number in the description field. See the '''[[Current_Versions | versions page]]''' for current version number and changelog information.<br />
<br />
= <span style="color:#00528c">'''Security Settings & Levels'''</span> =<br />
<br />
== '''Access Levels''' ==<br />
<br />
When Admins click into the access menu, they will get the following options: <br />
{| <br />
| [[File:CasperSafe - Access - Main.png|350px|thumb|left|Access main menu - click to see larger version.]]<br />
|}<br />
<br />
When Subadmins click into the access menu, their options will be a little different: <br />
{| <br />
| [[File:CasperSafe_-_Subadmin_-_Access_Version.png|350px|thumb|left|Subadmin version of access menu - click to see larger version.]]<br />
|}<br />
<br />
== '''Access Level Chart''' ==<br />
<br />
{| class="wikitable"<br />
|-<br />
! Main Menu Option<br />
! Guests<br />
! SubAdmins<br />
! Admins<br />
|-<br />
| Areas <br />
| No<br />
| No<br />
| Yes<br />
|-<br />
| Arm / Disarm<br />
| No<br />
| Yes<br />
| Yes<br />
|-<br />
| Lockdown<br />
| No<br />
| Yes<br />
| Yes<br />
|-<br />
| Link / Unlink (rental units)<br />
| No<br />
| No<br />
| Yes<br />
|-<br />
| Access Menu<br />
| No<br />
| Yes (subadmins / guests / ban list)<br />
| Yes<br />
|-<br />
| Options<br />
| No<br />
| No<br />
| Yes<br />
|-<br />
| Visitor Control Panel<br />
| No<br />
| Yes, no sales<br />
| Yes, with sales<br />
|}<br />
<br />
: '''Admins:''' This is the owner, plus any additional designated avatars added to the orb's Admin list. <br />
: '''SubAdmins:''' Usually subadmins are the tenants of a landlord. As a result, they will not have access to the options list or other higher administrative functions of the orb. <br />
: '''Guest:''' This option allows you to add a mostly permanent "whitelist" of allowed guests. Guest level does '''not''' come with menu access to the orb. <br />
: '''Temporary:''' Like the "Guest" level, except that people added to the temporary list are automatically removed after they leave the sim/region. <br />
: '''Banned:''' This option allows you to add to a list of "never allowed" avatars. Anyone on the ban list will automatically be ejected/teleported home (provided they HAVE a home point set...) upon arrival, if ejection is on and an enforcer is out (and properly deeded if necessary.) <br />
<br />
=== Security Notes ===<br />
----<br />
Each CasperSafe can only hold '''one''' set of security options. <br />
<br />
If you need to have different security settings for different areas, then you'll need one orb per set of security settings. <br />
<br />
Yes, you can rez multiple orbs on the same sim/region.<br />
<br />
:* When used with CasperLet, the owner and any CasperLet managers are automatically admins<br />
:* When used with CasperLet, the primary tenant + additional subtenants on that rental are added automatically to the SUBADMIN access list. <br />
:* Two CasperTech support avatars are added to the whitelist to make it easier to provide any needed support: Casper Warden and CasperHelp Resident.<br />
:* Lockdown mode automatically ends when the entire sim is empty of all allowed avatars.<br />
<br />
== '''Warning Times''' ==<br />
Minimum warning time of 10 seconds (default setting of 30 seconds). <br />
<br />
Lockdown mode warning time of explicitly 00 seconds (instantly ejected), regardless of normal warning time setting. Lockdown mode ends automatically when all allowed avatars leave the sim/region. <br />
<br />
If the avatar is explicitly on the orb's ban list "instant eject" .<br />
<br />
=== Ejected without warning? ===<br />
----<br />
CasperSafe '''always''' sends a warning first, before ejecting (when ejecting is properly configured) '''unless''' it is in "lockdown" mode. <br />
<br />
The times a visitor may not see the warning are: <br />
: 1) If they muted the orb<br />
: 2) If what they think was CasperSafe is actually a neighbour's non-CasperTech orb set to the wrong distance. <br />
<br />
Visitors normally receive a notice, either by popup or by local chat, indicating what they were ejected by.<br />
<br />
== '''CasperSafe Enforcer''' ==<br />
<br />
{{Warning|The CasperSafe Enforcer may ask for permission to return objects. Objects will ONLY be returned IF permissions are granted AND the option to return prims is enabled on the CasperSafe Orb. If activated, the orb will return prims belonging to an avatar when they are '''ejected'''. '''BE CAREFUL''' with this option - we accept no responsibility for any damage caused.}}<br />
<br />
This is the widget that actually does the ejecting / teleport home functions. Thus it is required if you actually want to be able to boot avatars out of the protected area - Otherwise CasperSafe operates in "Warning Mode" which basically nags the avatars instead. <br />
<br />
Like the '''[[CasperLet/Prim_Counter#Prim_Counter_Basics | CasperLet Prim Counter]]''', in order to function properly, the Enforcer widget must be owned by the LAND OWNER. If the land is owned by an individual, that individual must REZ the Enforcer widget. If the land is owned by a group, the Enforcer must be REZZED by an individual with the same group tag as the parcel, and they must then DEED the Enforcer to the group. If there are multiple land owners, then you will need one Enforcer per land owner.<br />
<br />
The permissions of the Enforcer widget are copy & transfer so that it can be deeded to the appropriate land owners.<br />
<br />
{{Critical|For security reasons, the enforcer will only respond to CasperSafe orbs belonging to its '''owner''', or in the case of the enforcer being deeded to group, orbs belonging to the either '''the owner or the previous owner''' (because the land owner isn't always the orb owner.) }}<br />
<br />
'''UPDATES:''' The enforcer only needs to be replaced when a new enforcer version goes out.<br />
<br />
=== Using Enforcer On Group Land Where You're Only Renting ===<br />
----<br />
:# Rez the enforcer - this sets a "bit" so that it know you're the original owner<br />
:# Rename it so you can find it in your inventory<br />
:# Pick up the enforcer<br />
:# Pass THAT copy of the enforcer to your landlord, so THEY can rez it out<br />
:# Landlord will need to deed the enforcer to the group (if group owned land)<br />
<br />
Do '''NOT''' pass over a fresh one that you haven't rezzed first, because it will NOT recognize instructions from your CasperSafe orb.<br />
<br />
=== Enforcer Must Stay Rezzed ===<br />
----<br />
The enforcer will not be able to eject avatars if it is only in your inventory, so yes, the enforcer '''must stay rezzed.''' <br />
<br />
=== One Enforcer Per Parcel ===<br />
----<br />
You only need one (1) enforcer '''per parcel''' - see the '''[[CasperLet/Prim_Counter#Sample_Land_Configurations | prim counter]]''' page for rezzing, when when you have to deed. <br />
<br />
The enforcer will turn all black when it is '''properly''' deeded or rezzed - this is normal and does NOT mean it's broken.<br />
<br />
=== Enforcer and Autoreturn ===<br />
----<br />
If you want the enforcer to utilize autoreturn, you must: <br />
<br />
:# Rez the CasperSafe orb '''first'''. <br />
:# Set up the autoreturn options in settings<br />
:# '''Then''' rez and deed the enforcer.<br />
<br />
=== Enforcer, Group Detection, Autreturn and You ===<br />
----<br />
If you are using '''group detection''', it is '''highly recommended''' that you '''do NOT''' use the object return feature, because people will always forget their group tag, and having object return on may result in an individual having their objects returned.<br />
<br />
= '''<span style="color:#00528c">Land Configuration - When Security Is Required</span>''' =<br />
All examples are on a '''per-region''' basis, and the Enforcer is '''ONLY''' required when you need security on an area in a parcel. If you are simply using it for visitor tracking, no enforcer is needed. <br />
<br />
Even if you have multiple CasperSafes on a parcel for different security settings, you only need ONE Enforcer per parcel. <br />
<br />
The CasperSafe Enforcer cannot operate across sim boundaries; you will need to repeat the appropriate steps for each sim/region that you have. <br />
<br />
{| class="wikitable" <br />
|-<br />
! style="white-space: nowrap; background: #33CCFF; border: 2px solid #383838;" | Land Owners On Sim/Region<br />
! style="white-space: nowrap; background: #33CCFF; border: 2px solid #383838;" | Actions To Take With CasperSafe Enforcer<br />
|-<br />
| Shared land, one parcel <br />Owned by YOU<br />
| <br />
# Rez '''one''' CasperSafe Enforcer, on land YOU own<br />
# No deeding required - just rez and wait<br />
# Repeat on each additional sim/region you have<br />
|-<br />
| Shared land, one parcel <br />Owned by ONE other avatar<br />
| <br />
# Transfer the CasperSafe Enforcer to THAT avatar<br />
# THEY must rez out ONE CasperSafe Enforcer on land owned by THEM<br />
# No deeding required - just rez<br />
# Repeat on each additional sim/region you have<br />
|-<br />
| Shared land, one parcel <br />Owned by ONE land group<br />
| <br />
# Rez out ONE CasperSafe Enforcer on land owned by that group<br />
# Right-Click > Edit > "Share with group" > "Deed"<br />
# Repeat on each additional sim/region you have<br />
|-<br />
| Shared land, multiple parcels <br />Some owned by YOU<br />Some by ONE land group<br />
| <br />
# Rez out one CasperSafe Enforcer on EACH group-owned parcel<br />
# Right-Click > Edit > "Share with group" > "Deed"<br />
# Rez out one CasperSafe Enforcer on EACH parcel owned by you<br />
# No deeding required on the land YOU own - just rez<br />
# Repeat on each additional sim/region you have<br />
|-<br />
| Shared land, multiple parcels <br />Owned by MULTIPLE land groups<br />
| <br />
# Rez one CasperSafe Enforcer PER land group, PER parcel<br />
# Right-Click > Edit > "Share with group" > "Deed"<br />
# Repeat on each additional sim/region you have<br />
|}<br />
<br />
= <span style="color:#00528c">'''Monitoring Areas'''</span> =<br />
Avatars are tracked by the area they're in. If an avatar is registered as entering two areas '''at the same time''' that have identical names, the system will end the first visit to avoid duplicates. <br />
<br />
Please ensure each area that is defined has its own unique name to avoid this! <br />
<br />
== Automatic Settings ==<br />
: * When used with CasperLet, the owner and any CasperLet managers are added automatically to the ADMIN access list. <br />
: * When used with CasperLet, the primary tenant + additional subtenants on that rental are added automatically to the SUBADMIN access list. <br />
: * Lockdown mode automatically ends when the sim/region is empty of all allowed avatars.<br />
<br />
=== Note for Skyboxes ===<br />
----<br />
<br />
If you only want to monitor an area NEAR a skybox, set the orb to monitor a '''range''' instead of the parcel. Parcel will assume you want to keep watch over all of the parcel, from "floor to ceiling".<br />
<br />
== Custom Areas ==<br />
'''Custom Areas: Suitable for odd shaped parcels, or a specific square/rectangular size within a parcel - Limited only by available memory'''<br />
<br />
:* Click for menu<br />
:* Select "Areas" <br />
:* Select "Add" <br />
:* Select "Custom" <br />
:* Corner markers will appear<br />
:* Drag the lower marker to the lowest corner of the area you want to monitor<br />
:* Drag the upper marker to the uppermost corner of the area you want to monitor<br />
:* Click one of the markers<br />
:* Select Save<br />
:* Name the area<br />
:* Done! <br />
<br />
If you accidentally manually delete one marker, the corresponding one will self-delete as well.<br />
<br />
==== Custom Area Issues ====<br />
----<br />
:# "Object Entry" '''must be allowed''' for ALL parcels you are dragging custom markers across.<br />
:# Parcels with autoreturn '''must''' give you enough time to do what you need to do before it will send them back. (You can always set autoreturn back to 1 when you're done.) <br />
<br />
Otherwise you'll see things like particles flying completely out of the parcel, and custom area markers/nodes being automatically returned.<br />
<br />
== Custom Range Radius ==<br />
'''Custom Ranges: Number limited only by amount of available memory in the orb.'''<br />
<br />
To set a custom area: <br />
<br />
:* Click the orb<br />
:* Select "Areas" <br />
:* Select "Add" <br />
:* Select "Range" <br />
:* Enter in the detection range, in meters, and click "Send" <br />
:* Enter name of the area, and click "Send" <br />
:* Done!<br />
<br />
Range = Radius. &nbsp;&nbsp;'''''[https://en.wikipedia.org/wiki/Radius What is a radius?]'''''<br />
<br />
== Parcel Link ==<br />
'''Number of Parcels: Limited only by amount of available memory in the orb.'''<br />
<br />
The Parcel Link Tool allows CasperSafe to be paired with one or more parcels. The Parcel Link Tool must be '''used''' on the parcel that will be linked to the CasperSafe orb, and '''ONLY''' by the owner of the orb. (Admins and subadmins cannot add a parcel using the Parcel Link Tool because the Tool is no-transfer.) This may be rezzed on any parcel and moved over, just be sure to allow a minute or two for it to pick up the change in parcels. <br />
<br />
: '''1)''' Rez the CasperSafe Security Orb on the land you want it to monitor<br />
: '''2)''' Rez the "Parcel Link Tool" - You will get these messages in local chat: <br />
Touch me to pair this parcel with your CasperSafe orb. <br />
Make sure you have started pairing on the orb by choosing AREA -> ADD -> PARCEL, first.<br />
I'm now over parcel ''((parcel name as seen in "about land" floater))''. Touch to register with a CasperSafe Orb.<br />
: '''3)''' On the CasperSafe orb, click for the popup menu<br />
: '''4)''' Select "Areas" <br />
: '''5)''' Select "Add" <br />
: '''5)''' Select "Parcel" <br />
: '''6)''' Then click the Parcel Link Tool. You'll see the following messages in local chat: <br />
OK. Trying to find a CasperSafe orb, please stand by.<br />
Alright, all done!<br />
Pairing process ended.<br />
: '''7)''' The Parcel Link Tool will self-delete when the parcel pairing process is completed. <br />
<br />
Pairing process usually takes 1-2 minutes, but may be longer if the region is heavily lagged.<br />
<br />
== Rental Unit Pairing ==<br />
=== '''Ownership''' ===<br />
----<br />
Rental unit AND the CasperSafe orb '''must''' be owned by the same avatar. This is for security reasons. (If anyone could do this, then anyone could control your security orb without your knowledge or permission.) <br />
<br />
=== '''Pairing Process''' ===<br />
----<br />
<br />
'''Pairing limit: 1 rental unit per orb'''<br />
<br />
'''NOTE:''' CasperSafe may be paired with only ONE rental unit. If you have multiple rental units out, AND you want to pair CasperSafe to the units, you'll need one CasperSafe per unit. <br />
<br />
: '''1)''' Rez CasperSafe Security Orb near the rental unit<br />
: '''2)''' Click CasperSafe for the main menu<br />
{| <br />
| [[File:CasperSafe_-_Main_Menu_-_Unarmed.png|350px|thumb|left|Default main menu - click to see larger version.]]<br />
|}<br />
: '''3)''' Select "LINK". You'll get a popup with instructions: <br />
{| <br />
| [[File:CasperSafe - Link Menu.png|350px|thumb|left|Default main menu - click to see larger version.]]<br />
|}<br />
: '''4)''' Drop the "Psychic Link Script" into the corresponding rental unit<br />
: '''5)''' Watch messages in local chat. If all goes well, you should see: <br />
Okay, let's have a look here..<br />
Ooh, CasperLet! Good choice! Searching for the orb..<br />
Cool! I'm paired with ''((name of rental unit))'' (Key: ''((uuid string))'' )<br />
Pairing process ended. <br />
: '''6)''' The orb will also add the CasperSafe system owner as an ADMIN automatically. <br />
<br />
Pairing process usually takes 1-2 minutes, but may be longer if the region is heavily lagged.<br />
<br />
=== CasperLet Manager Auto-Update Timing ===<br />
----<br />
<br />
CasperSafe will automatically pick up changes to CasperLet managers, '''HOWEVER''' it is not instant - It will take time to filter through, and will be the next time the rental unit updates info to/from the server.<br />
<br />
= <span style="color:#00528c">'''Main Menus'''</span> =<br />
<br />
=== Main Menu for Admins ===<br />
----<br />
<br />
By default, when you first rez out CasperSafe, the orb is in the "unarmed" state. When unarmed, the orb automatically runs in "discreet mode" in order to be kinder to region resources. <br />
{| <br />
| [[File:CasperSafe_-_Main_Menu_-_Unarmed.png|350px|thumb|left|Default main menu - click to see larger version.]]<br />
|}<br />
<br />
When you choose to arm the orb, you will also have an extra "lockdown" option, as shown here: <br />
{| <br />
| [[File:CasperSafe - Main Menu - Armed Mode.png |350px|thumb|left|Armed mode - click to see larger version.]]<br />
|}<br />
When CasperSafe is armed, the base menu will also show the option "Lockdown" - this changes the warning time to 10 seconds (reduced from the normal minimum of 20 seconds), and increases the scan frequency in order to detect possible threats more quickly.<br />
<br />
Also, when someone arrives who is not on any of the access lists, admins will get a popup asking them if they want to add the new arrival on a temporary or guest basis, or whether to ban. <br />
<br />
=== Main Menu for SubAdmins ===<br />
----<br />
Subadmins will typically be tenants of a landlord, and will not have administrator access to the higher functions of the security orb; they will only have access to the following menu items: <br />
:* Access list (to add fellow subadmins, guests and temporary guests) <br />
:* Arm/Disarm/Lockdown<br />
:* Visitor stats (if enabled)<br />
<br />
=== About Lockdown mode===<br />
----<br />
If the orb is currently '''in''' "lockdown" mode, the lockdown option will change to "stand down". <br />
<br />
This automatically disables itself when everyone ON the access list has left the sim/region - there is no time limit beyond that. <br />
<br />
Lockdown mode changes the operation to instant eject (from the normal minimum of 10 seconds), and uses slightly more script time than normal operation (see '''[[CasperSafe_Security_Orb#Script_Times | Script Times]]''' for details) in order to detect possible intrusions faster.<br />
<br />
= <span style="color:#00528c">'''Security Menus'''</span> =<br />
<br />
=== '''Configuration Options Menus''' ===<br />
----<br />
These are the default settings for the options menu, as it ships from CasperTech: <br />
{| <br />
| [[File:CS_Config_Options_Page_1.png|350px|thumb|left|Default Options page 1 - click to see larger version.]] | [[File:CS_Config_Options_Page_2.png|350px|thumb|left|Default Options page 2- click to see larger version.]]<br />
|}<br />
<br />
== '''Configuration Options Explanations''' ==<br />
<br />
{| class="wikitable"<br />
|-<br />
! Options Items<br />
! What it does<br />
|-<br />
| Floating Text<br />
| This turns the radar on and off. Having the radar on will use more script time and processing. <br />
|-<br />
| Disallow by default<br />
| When on, this will eject anyone who's not on the access list. <br />
|-<br />
| Discreet mode<br />
| When on, this slows down the timers to reduce lag. It won't be as responsive, but it will be kinder to region resources. <br />
|-<br />
| Eject from parcel <br />
| When on, this will eject unwanted visitors after the warning period has ended. <br />
|-<br />
| Teleport Home<br />
| When on, this will teleport unwanted visitors to their home point. <br />
|-<br />
| Add to parcel ban list<br />
| When on, this will add ejected avatars to the parcel's land ban list (not the ban list in the orb). <br />
|-<br />
| Warning Time<br />
| This controls how long the avatar can stay before being ejected, if eject mode is on. In "Warning mode" (which is the default, if there is no Enforcer present and/or properly deeded) this is how long before CasperSafe sends another warning to the intruding avatar. The shipped default is 30 seconds, and may be reduced to 20 seconds for normal operation. When in lockdown mode, the warning time is hard-set at 10 seconds. <br />
|-<br />
| Age Limit<br />
| When on, you configure the minimum number of days of account age before avatars are allowed in to the protected area. <br />
|-<br />
| Script Limit<br />
| When on, you configure the maximum amount of scripts an avatar may be wearing/using before they are allowed in to the protected area. <br />
|-<br />
| Visitor Tracking<br />
| When on, this tracks visitors and sends visitor data to the CasperTech website. Visitors cannot (currently) be filtered by admin/subadmin/guest levels; access list data is not sent to the website. You must have an '''[[CasperSafe_Security_Orb#Monitoring_Areas | area defined]]''' before tracking will actually take place. (The orb needs to know where to keep watch.) <br />
|-<br />
| Group members are guests<br />
| When on, allows members of the group the orb is rezzed under into the protected area. "Guest" access does not include any part of orb menus. <br />
|-<br />
| Group members are subadmins<br />
| When on, allows members of the group the orb is rezzed under both into the protected area '''and''' gives them subadmin access to the orb itself. <br />
|-<br />
| Limit detection to current parcel<br />
| When on, this limits detection ranges to within the borders of the parcel the orb is rezzed on. This prevents things like the orb's ejecting/banning from affecting users on other (unrelated) parcels. <br />
|-<br />
| Return prims when ejected<br />
| When on, uses the scripted prim autoreturn feature. This is not recommended in combination with group detection, because people often forget their group tag when they try to rez objects. <br />
|-<br />
| Don't send notifications to admins <br />
| When on, this prevents the orb from sending notifications to users on the "Admin" access level. By default, all messages are delivered via llRegionSay to prevent IM's from capping while you are offline. (If IM notifications are prefered, there is an optional script in the orb's shipping crate that will do this.) <br />
|-<br />
| Don't send notifications to subadmins<br />
| When on, this prevents the orb from sending notifications to users on the "SubAdmin" access level. By default, all messages are delivered via llRegionSay to prevent IM's from capping while you are offline. (If IM notifications are prefered, there is an optional script in the orb's shipping crate that will do this.)<br />
|-<br />
| Send notifications to guests<br />
| When on, this will send notifications to users on the "Guest" access level. By default they don't receive notifications. <br />
|-<br />
| No-Fly Zone<br />
| When on, the flying avatar is warned. If "Eject" is on, then the user is ejected from the area. If "Teleport Home" is on, then the user is teleported home. There is no height limit on flight detection. <br />
|-<br />
| Render Weight Limit<br />
| When on, you set the maximum avatar complexity that individual avatars should be at. Users above that point will be warned. If "Eject" is on, then the user is ejected from the area. If "Teleport Home" is on, then the user is teleported home. <br />
|}<br />
<br />
=== Memory Limits ===<br />
----<br />
Data about names for Admin/Subadmin/Guest lists are stored IN the device. Consequently every name that's added will cause the available memory to decrease, and it will give you a local chat message indicating how much memory is left. Once the available memory gets below a certain point (somewhere around 300 names), the orb will crash - so it's up to you to keep an eye on how much memory is being used. <br />
<br />
You CAN rez multiple orbs if you are getting low in memory on the first one.<br />
<br />
= <span style="color:#00528c">'''Render Weight'''</span> =<br />
<br />
The CasperSafe orb has the ability to eject avatars if their render weight (ARC) is too high. However, please be aware that:<br />
<br />
* It is '''not the same thing''' as avatar complexity, but represents the same thing.<br />
* It has a maximum value of 500,000. If you set your limit higher than this, it'll have no effect.<br />
* A render weight of 500,000 is '''roughly''' equivalent to an avatar complexity of 1 million.<br />
* Render weight is calculated by viewers, not the simulator, so it will only work if there are other people nearby.<br />
<br />
Please understand that this is not a predictable or reliable figure, it can vary based on many different factors, and can suffer from random "surges" with apparently no cause. For this reason, we '''do not recommend''' that you enforce a render weight limit. However, the option is there if you require it.<br />
<br />
We've '''[https://jira.secondlife.com/browse/BUG-100791 opened a Jira ticket]''' to request script access to avatar complexity. Vote if you want this feature!<br />
<br />
= <span style="color:#00528c">'''Checklist for Automatically Ejecting Avatars '''</span> =<br />
# Is the Enforcer rezzed out by the land owner? <br />
# Is the enforcer ON the parcel? <br />
# If it is group land, is the Enforcer deeded to the group? <br />
# Is it multiple parcels - and is there one Enforcer PER PARCEL? <br />
# Did you configure an area? (The orb needs to know where to kick avatars FROM...) <br />
# Under Options > Disallow, did you turn "disallow by default" to '''ON'''?<br />
# Is the orb even armed? (You should see "disarm" in the popup menu if it IS armed) <br />
# Has the avatar to be ejected been standing still BEFORE you turned on "disallow by default"? Once the avatar moves, they will be seen and ejected. If they stand still and '''don't''' move, they won't be ejected yet. <br />
# Are you using '''only''' the "teleport home" option? (SL limitation: If the avatar does NOT have a home point set, or the home point no longer exists, the avatar cannot be "sent home".) <br />
<br />
=== Group Tag Issues ===<br />
----<br />
If you have the CasperSafe set to only allow group members, your group members '''MUST ALREADY''' be wearing the group tag when they teleport in. CasperSafe will not recognize if they change tags once they arrive - they'll have to tp out then back to get the orb to see the proper group.<br />
<br />
= <span style="color:#00528c">'''Visitor Tracking '''</span> =<br />
<br />
:* Visitor tracking turns ON or OFF using the options menu (so only Admins may turn this on or off.) <br />
:* Visitor data WILL be sent to CasperTech servers when turned on.<br />
:* When visitor tracking is enabled, the "VISITORS" button will change to "CNTRL PANEL" - click the control panel button to get a link for the web-based visitor stats.<br />
:* You must also '''[[CasperSafe_Security_Orb#Monitoring_Areas | define an area]]''' for the tracking to monitor before visitor tracking will actually take place<br />
:* Visitor tracking does '''not''' require land ownership. You can rent in a mall and still track your mall store visitors.<br />
<br />
=== Missing or Ghosted Visitors ===<br />
----<br />
Every time an avatar enters or leaves an area (and visitor tracking is turned on), the orb must send a message to CasperPanel to let it know. It is expected that - from time to time - one of these message may be lost/dropped, which will either cause a missing visitor, or a visitor remaining visible who has really already left. <br />
<br />
This is normal and expected, from time to time, however it shouldn't happen too often. If you are experiencing this problem very often, please contact '''[[CasperVend_2/Getting_Help#2.29_When_Casper_is_offline:_By_IM-to-Webform | CasperTech support]]''' since there may be something wrong that we need to look at. <br />
<br />
You can fix this by resetting your orb. Your "current visitors" list will also be cleared when the region restarts.<br />
<br />
= <span style="color:#00528c">'''CasperVend and CasperSafe'''</span> =<br />
There is NO linking process required to hook up CasperSafe with CasperVend - this is automatic behind the scenes. If you have visitor list enabled, you will see icons that represent repeat visits, and whether they bought something on that visit. <br />
<br />
= <span style="color:#00528c">'''Customising Your Orb'''</span> =<br />
The default CasperSafe Orb object has 1 prim and 2 faces: <br />
:* The main decorative texture with triangular shapes is face #0<br />
:* The "war is peace" strip is face #1<br />
:* The orb does '''NOT''' check for prim creator - you can use any object to put the scripts in<br />
<br />
=== Textures & Custom Objects ===<br />
----<br />
If you simply don't want the "war is peace" strip to change, there is a notecard in the shipping crate labeled '''DISABLE_TEXTURE_CHANGE''' - simply drop that in the orb's contents, and it will disable further color changes to that strip. <br />
<br />
Alternately, you can rez a simple prim sphere and copy all the contents of the orb to that - an unmodified legacy prim sphere has only face #0. <br />
<br />
'''NOTE:''' Currently, the "Disable texture change" does NOT change the texture animation. Please keep that in mind when making a custom object. <br />
<br />
=== Notifications ===<br />
----<br />
If you want the notifications for your staff to arrive as an object IM instead of a llRegionSay message (so they can potentially reach your staff when they are not in the sim/region) then simply drop the script labeled '''Optional Plugin: Send IMs to staff''' into the orb object, and it will do the rest. <br />
<br />
The optional plugin script is '''open source''' - therefore any changes you make to the script are '''your responsibility''', and are unsupported by CasperTech.<br />
<br />
==== Popup Menu Notifications ====<br />
----<br />
You cannot turn these off at this time, but that functionality is expected to be added in the next release.<br />
<br />
= <span style="color:#00528c">'''API Information'''</span> =<br />
<br />
Per Casper: <br />
'''We haven't yet published the API for CasperSafe.'''<br />
<br />
There is currently no date for when the API will be released. When it is released, it will be inserted into this space. If you are still seeing THIS message, the API information has not been released yet.<br />
<br />
= <span style="color:#00528c">'''Limitations'''</span> =<br />
:* No website configuration<br /> <i>All configuration of the orb itself is done inworld. While it stores minor configuration information online as a backup, it is designed to stay functional even if CasperTech web services have issues.</i><br />
:* Shift-drag-copy loses configuration<br /><i>The new copy will lose all configuration due to a new UUID created which has no record on the database. You may, however, '''take a copy''' of an orb with the desired configuration and rez as many additional copies of that as you please. </i><br />
:* Cannot filter visitor tracking by access level <br /><i>Access level of the avatar is not sent with the visit statistics. </i><br />
:* One orb per set of security settings<br /><i>While the orb can track multiple areas and parcels without an issue, it is only designed to hold ONE set of security settings. You cannot choose to eject people from one area while not ejecting them from another - you'll need multiple orbs. Yes, you can rez multiple orbs on a parcel and a sim/region. </i><br />
:* Land bans limited to the parcel the CasperSafe Enforcer is on<br /><i>llAddToLandBanList only works for the parcel the enforcer is currently on.</i><br />
:* One CasperSafe Enforcer per parcel<br /><i>If the land is group owned, the Enforcer unit will need to be deeded, using the same process as if you were '''[[CasperLet/Prim_Counter#How_to_Properly_Deed_a_Prim_Counter | deeding a prim counter.]]'''</i><br />
:* Deleting areas doesn't remove current visitors<br><i>If you delete an area, any avatars shown as currently visiting the area on the website will not be removed until the next time the orb is reset or the region is restarted.</i><br />
:* No avatar height restrictions<br /><i>CasperSafe does not support any sort of avatar height restriction. Since the introduction of mesh avatars, you can no longer depend on avatar height as being a psuedo-reliable indicator of the avatar's "age". There are many non-child avatars that are also short, and non-human avatars can come in many sizes as well. Height restrictions are therefore irrelevant today, and would eliminate too many '''legitimate''' avatars.</i><br />
:* No instant eject mode<br /><i>CasperSafe is designed to be fair to all. Security devices which are set to less than 10 seconds do not provide ample opportunity for passer-bys to vacate the area voluntarily - for the above reason, we don't support an "instant" eject mode. However, those who are on the "Ban" list '''will''' be ejected instantly.</i><br />
:* Cannot manually eject via the orb<br /><i>CasperSafe is only set up to eject in response to an allow prompt.</i><br />
<br />
= <span style="color:#00528c">'''Script Times'''</span> =<br />
<br />
These timings were measured over a 24 hour period, on a relatively quiet full region (Izanagi). Your mileage may vary, and times may be higher on busy sims.<br />
<br />
: UNARMED - 0.003ms<br />
: DISCREET - 0.003ms<br />
: ARMED - 0.004ms<br />
: LOCKDOWN - 0.005ms<br />
: ARMED + RADAR - 0.006ms<br />
: LOCKDOWN + RADAR - 0.007ms<br />
<br />
= <span style="color:#00528c">'''Error Messages'''</span> =<br />
: '''"Script asking non-owner for run time permissions only owner can grant" '''<br />
:: This is only referring to the scripted autoreturn permissions. They can only be granted by an OWNER in the land group. All other functions of the enforcer are unaffected by granting - or not granting - the autoreturn capability.<br />
<br />
:'''ChangeQueue is full! Too many events to send to the server!'''<br />
:: Casper needs to debug that. Please '''[[CasperVend_2/Getting_Help#2.29_When_Casper_is_offline:_By_IM-to-Webform_.28Preferred.29 | file a ticket]]''' and leave the orb out where Casper can access it.<br />
<br />
= <span style="color:#00528c">'''Troubleshooting / FAQ'''</span> =<br />
:'''Q. I'm seeing (one or more of) my managers get removed from the orb, but when I list the admins, they're still showing on the orb's list.'''<br />
::'''A.''' CasperSafe clears the list and re-adds them each time it is reset - this is part of the reset process. It is supposed to silence these messages, but sometimes (due to grid things) the messages are processed out of sequence and the remove message is processed before the silence message.</div>24607dde-d704-4db7-afa0-d9edc17c926chttps://wiki.casperdns.com/index.php?title=CasperSafe_Security_Orb&diff=14730CasperSafe Security Orb2021-07-01T21:35:53Z<p>24607dde-d704-4db7-afa0-d9edc17c926c: /* Warning Times */</p>
<hr />
<div>{|align=right<br />
|__TOC__<br />
|}<br />
<br />
{{Warning|Orb not ejecting? Please see the [[#Checklist_for_Automatically_Ejecting_Avatars|Checklist for Automatically Ejecting Avatars]], particularly the "Disallow by default" option. This is the most common support query for CasperSafe.}}<br />
<br />
= <span style="color:#00528c">'''About CasperSafe'''</span> =<br />
<br />
CasperSafe is a high-tech security and visitor tracking system. Its features include: <br />
<br />
* Self-contained configuration - no notecards<br />
* Fewer scripts than competing products - 4 instead of 11-13 scripts<br />
* CasperLet Support<br />
* Visitor Tracking option<br />
* Region-wide operation<br />
* Capable of monitoring many parcels at once<br />
<br />
{{Information|Depending on your viewer configuration (fonts, UI size, etc.) the length of the option names may not be identical to what's shown here. Popup menus shown here are from Viewer 3.}}<br />
<br />
= <span style="color:#00528c">'''What's in the Box?'''</span> =<br />
The following named items are in the shipping crate: <br />
:: CasperSafe Enforcer<br />
:: CasperSafe Parcel Link Tool<br />
:: CasperSafe Psychic Link Script (Read the instructions!) <br />
:: CasperSafe Security Orb<br />
<br />
Along with a landmark to the CasperTech store.<br />
<br />
= <span style="color:#00528c">'''What's with the 'war is peace' stuff?'''</span> =<br />
<br />
The orb has been themed in several ways with tongue-in-cheek references to George Orwell's 1984, a novel about totalitarian control, monitoring and mind control. It's not a political statement, just a cultural reference.<br />
<br />
= <span style="color:#00528c">'''Quick Setup Steps'''</span> =<br />
:# Rez the shipping crate and unpack<br />
:# Rez out the CasperSafe Security Orb<br />
:# '''[[CasperSafe_Security_Orb#Add_Areas | Add areas]]''' and/or '''[[CasperSafe_Security_Orb#Link_to_Rental_Unit | link to rental unit]]'''<br />
:# Rez (and deed if necessary) the '''[[CasperSafe_Security_Orb#CasperSafe_Enforcer | Enforcer unit]]'''<br />
:# Add people to appropriate '''[[CasperSafe_Security_Orb#Access_Levels | access lists]]'''<br />
:# Arm the orb<br />
<br />
See the sections below for explanations of all the options.<br />
<br />
= <span style="color:#00528c">'''Configuration Tips'''</span> =<br />
<br />
CasperSafe will save its configuration on the server. Like CasperLet and SimpleSit, this is saves the information against the UUID of the device, barring a complete script reset (which makes it forget everything) or shift-drag-copy (the copy that is left behind has both reset the script AND has a new UUID and thus no old configuration.) <br />
<br />
:* Takes about 20-30 seconds to save configuration changes. <br />
:* Configuration is kept when you "Take a copy" '''then''' Rez the copy<br />
:* Configuration is '''NOT''' kept when you shift > drag > copy (this resets the script) <br />
:* Like CasperLet, the script tracks the UUID of the device. New device = new UUID, thus shift > drag > copy = New device and new UUID. <br />
:* Information will NOT transfer between two unrelated or different version orbs. (This would be a hassle for landlords, where different orbs are expected to have different individual configurations depending on the renter.)<br />
:* When used with CasperLet, the owner and any CasperLet managers are automatically admins<br />
:* When used with CasperLet, the primary tenant + additional subtenants on that rental are added automatically to the SUBADMIN access list. <br />
<br />
CasperSafe is '''not''' meant to be configured via the website - while this may make it less convenient, this does ensure that it continues to function despite any website outage.<br />
<br />
=== Checking Version Number ===<br />
----<br />
Because the UpgradeBee does '''NOT''' rename the object, if you wish to verify that your orb(s) have been updated, you will need to edit > contents tab > right-click on one of the scripts > select "Properties" > check the version number in the description field. See the '''[[Current_Versions | versions page]]''' for current version number and changelog information.<br />
<br />
= <span style="color:#00528c">'''Security Settings & Levels'''</span> =<br />
<br />
== '''Access Levels''' ==<br />
<br />
When Admins click into the access menu, they will get the following options: <br />
{| <br />
| [[File:CasperSafe - Access - Main.png|350px|thumb|left|Access main menu - click to see larger version.]]<br />
|}<br />
<br />
When Subadmins click into the access menu, their options will be a little different: <br />
{| <br />
| [[File:CasperSafe_-_Subadmin_-_Access_Version.png|350px|thumb|left|Subadmin version of access menu - click to see larger version.]]<br />
|}<br />
<br />
== '''Access Level Chart''' ==<br />
<br />
{| class="wikitable"<br />
|-<br />
! Main Menu Option<br />
! Guests<br />
! SubAdmins<br />
! Admins<br />
|-<br />
| Areas <br />
| No<br />
| No<br />
| Yes<br />
|-<br />
| Arm / Disarm<br />
| No<br />
| Yes<br />
| Yes<br />
|-<br />
| Lockdown<br />
| No<br />
| Yes<br />
| Yes<br />
|-<br />
| Link / Unlink (rental units)<br />
| No<br />
| No<br />
| Yes<br />
|-<br />
| Access Menu<br />
| No<br />
| Yes (subadmins / guests / ban list)<br />
| Yes<br />
|-<br />
| Options<br />
| No<br />
| No<br />
| Yes<br />
|-<br />
| Visitor Control Panel<br />
| No<br />
| Yes, no sales<br />
| Yes, with sales<br />
|}<br />
<br />
: '''Admins:''' This is the owner, plus any additional designated avatars added to the orb's Admin list. <br />
: '''SubAdmins:''' Usually subadmins are the tenants of a landlord. As a result, they will not have access to the options list or other higher administrative functions of the orb. <br />
: '''Guest:''' This option allows you to add a mostly permanent "whitelist" of allowed guests. Guest level does '''not''' come with menu access to the orb. <br />
: '''Temporary:''' Like the "Guest" level, except that people added to the temporary list are automatically removed after they leave the sim/region. <br />
: '''Banned:''' This option allows you to add to a list of "never allowed" avatars. Anyone on the ban list will automatically be ejected/teleported home (provided they HAVE a home point set...) upon arrival, if ejection is on and an enforcer is out (and properly deeded if necessary.) <br />
<br />
=== Security Notes ===<br />
----<br />
Each CasperSafe can only hold '''one''' set of security options. <br />
<br />
If you need to have different security settings for different areas, then you'll need one orb per set of security settings. <br />
<br />
Yes, you can rez multiple orbs on the same sim/region.<br />
<br />
:* When used with CasperLet, the owner and any CasperLet managers are automatically admins<br />
:* When used with CasperLet, the primary tenant + additional subtenants on that rental are added automatically to the SUBADMIN access list. <br />
:* Two CasperTech support avatars are added to the whitelist to make it easier to provide any needed support: Casper Warden and CasperHelp Resident.<br />
:* Lockdown mode automatically ends when the entire sim is empty of all allowed avatars.<br />
<br />
== '''Warning Times''' ==<br />
Minimum warning time of 10 seconds (default setting of 30 seconds). <br />
<br />
Lockdown mode warning time of explicitly 00 seconds (instantly ejected), regardless of normal warning time setting. Lockdown mode ends automatically when all allowed avatars leave the sim/region. <br />
<br />
If the avatar is explicitly on the orb's ban list "instant eject" .<br />
<br />
=== Ejected without warning? ===<br />
----<br />
CasperSafe '''always''' sends a warning first, before ejecting (when ejecting is properly configured) '''unless''' it is in "lockdown" mode. <br />
<br />
The times a visitor may not see the warning are: <br />
: 1) If they muted the orb<br />
: 2) If what they think was CasperSafe is actually a neighbour's non-CasperTech orb set to the wrong distance. <br />
<br />
Visitors normally receive a notice, either by popup or by local chat, indicating what they were ejected by.<br />
<br />
== '''CasperSafe Enforcer''' ==<br />
<br />
{{Warning|The CasperSafe Enforcer may ask for permission to return objects. Objects will ONLY be returned IF permissions are granted AND the option to return prims is enabled on the CasperSafe Orb. If activated, the orb will return prims belonging to an avatar when they are '''ejected'''. '''BE CAREFUL''' with this option - we accept no responsibility for any damage caused.}}<br />
<br />
This is the widget that actually does the ejecting / teleport home functions. Thus it is required if you actually want to be able to boot avatars out of the protected area - Otherwise CasperSafe operates in "Warning Mode" which basically nags the avatars instead. <br />
<br />
Like the '''[[CasperLet/Prim_Counter#Prim_Counter_Basics | CasperLet Prim Counter]]''', in order to function properly, the Enforcer widget must be owned by the LAND OWNER. If the land is owned by an individual, that individual must REZ the Enforcer widget. If the land is owned by a group, the Enforcer must be REZZED by an individual with the same group tag as the parcel, and they must then DEED the Enforcer to the group. If there are multiple land owners, then you will need one Enforcer per land owner.<br />
<br />
The permissions of the Enforcer widget are copy & transfer so that it can be deeded to the appropriate land owners.<br />
<br />
{{Critical|For security reasons, the enforcer will only respond to CasperSafe orbs belonging to its '''owner''', or in the case of the enforcer being deeded to group, orbs belonging to the either '''the owner or the previous owner''' (because the land owner isn't always the orb owner.) }}<br />
<br />
'''UPDATES:''' The enforcer only needs to be replaced when a new enforcer version goes out.<br />
<br />
=== Using Enforcer On Group Land Where You're Only Renting ===<br />
----<br />
:# Rez the enforcer - this sets a "bit" so that it know you're the original owner<br />
:# Rename it so you can find it in your inventory<br />
:# Pick up the enforcer<br />
:# Pass THAT copy of the enforcer to your landlord, so THEY can rez it out<br />
:# Landlord will need to deed the enforcer to the group (if group owned land)<br />
<br />
Do '''NOT''' pass over a fresh one that you haven't rezzed first, because it will NOT recognize instructions from your CasperSafe orb.<br />
<br />
=== Enforcer Must Stay Rezzed ===<br />
----<br />
The enforcer will not be able to eject avatars if it is only in your inventory, so yes, the enforcer '''must stay rezzed.''' <br />
<br />
=== One Enforcer Per Parcel ===<br />
----<br />
You only need one (1) enforcer '''per parcel''' - see the '''[[CasperLet/Prim_Counter#Sample_Land_Configurations | prim counter]]''' page for rezzing, when when you have to deed. <br />
<br />
The enforcer will turn all black when it is '''properly''' deeded or rezzed - this is normal and does NOT mean it's broken.<br />
<br />
=== Enforcer and Autoreturn ===<br />
----<br />
If you want the enforcer to utilize autoreturn, you must: <br />
<br />
:# Rez the CasperSafe orb '''first'''. <br />
:# Set up the autoreturn options in settings<br />
:# '''Then''' rez and deed the enforcer.<br />
<br />
=== Enforcer, Group Detection, Autreturn and You ===<br />
----<br />
If you are using '''group detection''', it is '''highly recommended''' that you '''do NOT''' use the object return feature, because people will always forget their group tag, and having object return on may result in an individual having their objects returned.<br />
<br />
= '''<span style="color:#00528c">Land Configuration - When Security Is Required</span>''' =<br />
All examples are on a '''per-region''' basis, and the Enforcer is '''ONLY''' required when you need security on an area in a parcel. If you are simply using it for visitor tracking, no enforcer is needed. <br />
<br />
Even if you have multiple CasperSafes on a parcel for different security settings, you only need ONE Enforcer per parcel. <br />
<br />
The CasperSafe Enforcer cannot operate across sim boundaries; you will need to repeat the appropriate steps for each sim/region that you have. <br />
<br />
{| class="wikitable" <br />
|-<br />
! style="white-space: nowrap; background: #33CCFF; border: 2px solid #383838;" | Land Owners On Sim/Region<br />
! style="white-space: nowrap; background: #33CCFF; border: 2px solid #383838;" | Actions To Take With CasperSafe Enforcer<br />
|-<br />
| Shared land, one parcel <br />Owned by YOU<br />
| <br />
# Rez '''one''' CasperSafe Enforcer, on land YOU own<br />
# No deeding required - just rez and wait<br />
# Repeat on each additional sim/region you have<br />
|-<br />
| Shared land, one parcel <br />Owned by ONE other avatar<br />
| <br />
# Transfer the CasperSafe Enforcer to THAT avatar<br />
# THEY must rez out ONE CasperSafe Enforcer on land owned by THEM<br />
# No deeding required - just rez<br />
# Repeat on each additional sim/region you have<br />
|-<br />
| Shared land, one parcel <br />Owned by ONE land group<br />
| <br />
# Rez out ONE CasperSafe Enforcer on land owned by that group<br />
# Right-Click > Edit > "Share with group" > "Deed"<br />
# Repeat on each additional sim/region you have<br />
|-<br />
| Shared land, multiple parcels <br />Some owned by YOU<br />Some by ONE land group<br />
| <br />
# Rez out one CasperSafe Enforcer on EACH group-owned parcel<br />
# Right-Click > Edit > "Share with group" > "Deed"<br />
# Rez out one CasperSafe Enforcer on EACH parcel owned by you<br />
# No deeding required on the land YOU own - just rez<br />
# Repeat on each additional sim/region you have<br />
|-<br />
| Shared land, multiple parcels <br />Owned by MULTIPLE land groups<br />
| <br />
# Rez one CasperSafe Enforcer PER land group, PER parcel<br />
# Right-Click > Edit > "Share with group" > "Deed"<br />
# Repeat on each additional sim/region you have<br />
|}<br />
<br />
= <span style="color:#00528c">'''Monitoring Areas'''</span> =<br />
Avatars are tracked by the area they're in. If an avatar is registered as entering two areas '''at the same time''' that have identical names, the system will end the first visit to avoid duplicates. <br />
<br />
Please ensure each area that is defined has its own unique name to avoid this! <br />
<br />
== Automatic Settings ==<br />
: * When used with CasperLet, the owner and any CasperLet managers are added automatically to the ADMIN access list. <br />
: * When used with CasperLet, the primary tenant + additional subtenants on that rental are added automatically to the SUBADMIN access list. <br />
: * Lockdown mode automatically ends when the sim/region is empty of all allowed avatars.<br />
<br />
=== Note for Skyboxes ===<br />
----<br />
<br />
If you only want to monitor an area NEAR a skybox, set the orb to monitor a '''range''' instead of the parcel. Parcel will assume you want to keep watch over all of the parcel, from "floor to ceiling".<br />
<br />
== Custom Areas ==<br />
'''Custom Areas: Suitable for odd shaped parcels, or a specific square/rectangular size within a parcel - Limited only by available memory'''<br />
<br />
:* Click for menu<br />
:* Select "Areas" <br />
:* Select "Add" <br />
:* Select "Custom" <br />
:* Corner markers will appear<br />
:* Drag the lower marker to the lowest corner of the area you want to monitor<br />
:* Drag the upper marker to the uppermost corner of the area you want to monitor<br />
:* Click one of the markers<br />
:* Select Save<br />
:* Name the area<br />
:* Done! <br />
<br />
If you accidentally manually delete one marker, the corresponding one will self-delete as well.<br />
<br />
==== Custom Area Issues ====<br />
----<br />
:# "Object Entry" '''must be allowed''' for ALL parcels you are dragging custom markers across.<br />
:# Parcels with autoreturn '''must''' give you enough time to do what you need to do before it will send them back. (You can always set autoreturn back to 1 when you're done.) <br />
<br />
Otherwise you'll see things like particles flying completely out of the parcel, and custom area markers/nodes being automatically returned.<br />
<br />
== Custom Range Radius ==<br />
'''Custom Ranges: Number limited only by amount of available memory in the orb.'''<br />
<br />
To set a custom area: <br />
<br />
:* Click the orb<br />
:* Select "Areas" <br />
:* Select "Add" <br />
:* Select "Range" <br />
:* Enter in the detection range, in meters, and click "Send" <br />
:* Enter name of the area, and click "Send" <br />
:* Done!<br />
<br />
Range = Radius. &nbsp;&nbsp;'''''[https://en.wikipedia.org/wiki/Radius What is a radius?]'''''<br />
<br />
== Parcel Link ==<br />
'''Number of Parcels: Limited only by amount of available memory in the orb.'''<br />
<br />
The Parcel Link Tool allows CasperSafe to be paired with one or more parcels. The Parcel Link Tool must be '''used''' on the parcel that will be linked to the CasperSafe orb, and '''ONLY''' by the owner of the orb. (Admins and subadmins cannot add a parcel using the Parcel Link Tool because the Tool is no-transfer.) This may be rezzed on any parcel and moved over, just be sure to allow a minute or two for it to pick up the change in parcels. <br />
<br />
: '''1)''' Rez the CasperSafe Security Orb on the land you want it to monitor<br />
: '''2)''' Rez the "Parcel Link Tool" - You will get these messages in local chat: <br />
Touch me to pair this parcel with your CasperSafe orb. <br />
Make sure you have started pairing on the orb by choosing AREA -> ADD -> PARCEL, first.<br />
I'm now over parcel ''((parcel name as seen in "about land" floater))''. Touch to register with a CasperSafe Orb.<br />
: '''3)''' On the CasperSafe orb, click for the popup menu<br />
: '''4)''' Select "Areas" <br />
: '''5)''' Select "Add" <br />
: '''5)''' Select "Parcel" <br />
: '''6)''' Then click the Parcel Link Tool. You'll see the following messages in local chat: <br />
OK. Trying to find a CasperSafe orb, please stand by.<br />
Alright, all done!<br />
Pairing process ended.<br />
: '''7)''' The Parcel Link Tool will self-delete when the parcel pairing process is completed. <br />
<br />
Pairing process usually takes 1-2 minutes, but may be longer if the region is heavily lagged.<br />
<br />
== Rental Unit Pairing ==<br />
=== '''Ownership''' ===<br />
----<br />
Rental unit AND the CasperSafe orb '''must''' be owned by the same avatar. This is for security reasons. (If anyone could do this, then anyone could control your security orb without your knowledge or permission.) <br />
<br />
=== '''Pairing Process''' ===<br />
----<br />
<br />
'''Pairing limit: 1 rental unit per orb'''<br />
<br />
'''NOTE:''' CasperSafe may be paired with only ONE rental unit. If you have multiple rental units out, AND you want to pair CasperSafe to the units, you'll need one CasperSafe per unit. <br />
<br />
: '''1)''' Rez CasperSafe Security Orb near the rental unit<br />
: '''2)''' Click CasperSafe for the main menu<br />
{| <br />
| [[File:CasperSafe_-_Main_Menu_-_Unarmed.png|350px|thumb|left|Default main menu - click to see larger version.]]<br />
|}<br />
: '''3)''' Select "LINK". You'll get a popup with instructions: <br />
{| <br />
| [[File:CasperSafe - Link Menu.png|350px|thumb|left|Default main menu - click to see larger version.]]<br />
|}<br />
: '''4)''' Drop the "Psychic Link Script" into the corresponding rental unit<br />
: '''5)''' Watch messages in local chat. If all goes well, you should see: <br />
Okay, let's have a look here..<br />
Ooh, CasperLet! Good choice! Searching for the orb..<br />
Cool! I'm paired with ''((name of rental unit))'' (Key: ''((uuid string))'' )<br />
Pairing process ended. <br />
: '''6)''' The orb will also add the CasperSafe system owner as an ADMIN automatically. <br />
<br />
Pairing process usually takes 1-2 minutes, but may be longer if the region is heavily lagged.<br />
<br />
=== CasperLet Manager Auto-Update Timing ===<br />
----<br />
<br />
CasperSafe will automatically pick up changes to CasperLet managers, '''HOWEVER''' it is not instant - It will take time to filter through, and will be the next time the rental unit updates info to/from the server.<br />
<br />
= <span style="color:#00528c">'''Main Menus'''</span> =<br />
<br />
=== Main Menu for Admins ===<br />
----<br />
<br />
By default, when you first rez out CasperSafe, the orb is in the "unarmed" state. When unarmed, the orb automatically runs in "discreet mode" in order to be kinder to region resources. <br />
{| <br />
| [[File:CasperSafe_-_Main_Menu_-_Unarmed.png|350px|thumb|left|Default main menu - click to see larger version.]]<br />
|}<br />
<br />
When you choose to arm the orb, you will also have an extra "lockdown" option, as shown here: <br />
{| <br />
| [[File:CasperSafe - Main Menu - Armed Mode.png |350px|thumb|left|Armed mode - click to see larger version.]]<br />
|}<br />
When CasperSafe is armed, the base menu will also show the option "Lockdown" - this changes the warning time to 10 seconds (reduced from the normal minimum of 20 seconds), and increases the scan frequency in order to detect possible threats more quickly.<br />
<br />
Also, when someone arrives who is not on any of the access lists, admins will get a popup asking them if they want to add the new arrival on a temporary or guest basis, or whether to ban. <br />
<br />
=== Main Menu for SubAdmins ===<br />
----<br />
Subadmins will typically be tenants of a landlord, and will not have administrator access to the higher functions of the security orb; they will only have access to the following menu items: <br />
:* Access list (to add fellow subadmins, guests and temporary guests) <br />
:* Arm/Disarm/Lockdown<br />
:* Visitor stats (if enabled)<br />
<br />
=== About Lockdown mode===<br />
----<br />
If the orb is currently '''in''' "lockdown" mode, the lockdown option will change to "stand down". <br />
<br />
This automatically disables itself when everyone ON the access list has left the sim/region - there is no time limit beyond that. <br />
<br />
Lockdown mode changes the warning time to 10 seconds (from the normal minimum of 20), and uses slightly more script time than normal operation (see '''[[CasperSafe_Security_Orb#Script_Times | Script Times]]''' for details) in order to detect possible intrusions faster.<br />
<br />
= <span style="color:#00528c">'''Security Menus'''</span> =<br />
<br />
=== '''Configuration Options Menus''' ===<br />
----<br />
These are the default settings for the options menu, as it ships from CasperTech: <br />
{| <br />
| [[File:CS_Config_Options_Page_1.png|350px|thumb|left|Default Options page 1 - click to see larger version.]] | [[File:CS_Config_Options_Page_2.png|350px|thumb|left|Default Options page 2- click to see larger version.]]<br />
|}<br />
<br />
== '''Configuration Options Explanations''' ==<br />
<br />
{| class="wikitable"<br />
|-<br />
! Options Items<br />
! What it does<br />
|-<br />
| Floating Text<br />
| This turns the radar on and off. Having the radar on will use more script time and processing. <br />
|-<br />
| Disallow by default<br />
| When on, this will eject anyone who's not on the access list. <br />
|-<br />
| Discreet mode<br />
| When on, this slows down the timers to reduce lag. It won't be as responsive, but it will be kinder to region resources. <br />
|-<br />
| Eject from parcel <br />
| When on, this will eject unwanted visitors after the warning period has ended. <br />
|-<br />
| Teleport Home<br />
| When on, this will teleport unwanted visitors to their home point. <br />
|-<br />
| Add to parcel ban list<br />
| When on, this will add ejected avatars to the parcel's land ban list (not the ban list in the orb). <br />
|-<br />
| Warning Time<br />
| This controls how long the avatar can stay before being ejected, if eject mode is on. In "Warning mode" (which is the default, if there is no Enforcer present and/or properly deeded) this is how long before CasperSafe sends another warning to the intruding avatar. The shipped default is 30 seconds, and may be reduced to 20 seconds for normal operation. When in lockdown mode, the warning time is hard-set at 10 seconds. <br />
|-<br />
| Age Limit<br />
| When on, you configure the minimum number of days of account age before avatars are allowed in to the protected area. <br />
|-<br />
| Script Limit<br />
| When on, you configure the maximum amount of scripts an avatar may be wearing/using before they are allowed in to the protected area. <br />
|-<br />
| Visitor Tracking<br />
| When on, this tracks visitors and sends visitor data to the CasperTech website. Visitors cannot (currently) be filtered by admin/subadmin/guest levels; access list data is not sent to the website. You must have an '''[[CasperSafe_Security_Orb#Monitoring_Areas | area defined]]''' before tracking will actually take place. (The orb needs to know where to keep watch.) <br />
|-<br />
| Group members are guests<br />
| When on, allows members of the group the orb is rezzed under into the protected area. "Guest" access does not include any part of orb menus. <br />
|-<br />
| Group members are subadmins<br />
| When on, allows members of the group the orb is rezzed under both into the protected area '''and''' gives them subadmin access to the orb itself. <br />
|-<br />
| Limit detection to current parcel<br />
| When on, this limits detection ranges to within the borders of the parcel the orb is rezzed on. This prevents things like the orb's ejecting/banning from affecting users on other (unrelated) parcels. <br />
|-<br />
| Return prims when ejected<br />
| When on, uses the scripted prim autoreturn feature. This is not recommended in combination with group detection, because people often forget their group tag when they try to rez objects. <br />
|-<br />
| Don't send notifications to admins <br />
| When on, this prevents the orb from sending notifications to users on the "Admin" access level. By default, all messages are delivered via llRegionSay to prevent IM's from capping while you are offline. (If IM notifications are prefered, there is an optional script in the orb's shipping crate that will do this.) <br />
|-<br />
| Don't send notifications to subadmins<br />
| When on, this prevents the orb from sending notifications to users on the "SubAdmin" access level. By default, all messages are delivered via llRegionSay to prevent IM's from capping while you are offline. (If IM notifications are prefered, there is an optional script in the orb's shipping crate that will do this.)<br />
|-<br />
| Send notifications to guests<br />
| When on, this will send notifications to users on the "Guest" access level. By default they don't receive notifications. <br />
|-<br />
| No-Fly Zone<br />
| When on, the flying avatar is warned. If "Eject" is on, then the user is ejected from the area. If "Teleport Home" is on, then the user is teleported home. There is no height limit on flight detection. <br />
|-<br />
| Render Weight Limit<br />
| When on, you set the maximum avatar complexity that individual avatars should be at. Users above that point will be warned. If "Eject" is on, then the user is ejected from the area. If "Teleport Home" is on, then the user is teleported home. <br />
|}<br />
<br />
=== Memory Limits ===<br />
----<br />
Data about names for Admin/Subadmin/Guest lists are stored IN the device. Consequently every name that's added will cause the available memory to decrease, and it will give you a local chat message indicating how much memory is left. Once the available memory gets below a certain point (somewhere around 300 names), the orb will crash - so it's up to you to keep an eye on how much memory is being used. <br />
<br />
You CAN rez multiple orbs if you are getting low in memory on the first one.<br />
<br />
= <span style="color:#00528c">'''Render Weight'''</span> =<br />
<br />
The CasperSafe orb has the ability to eject avatars if their render weight (ARC) is too high. However, please be aware that:<br />
<br />
* It is '''not the same thing''' as avatar complexity, but represents the same thing.<br />
* It has a maximum value of 500,000. If you set your limit higher than this, it'll have no effect.<br />
* A render weight of 500,000 is '''roughly''' equivalent to an avatar complexity of 1 million.<br />
* Render weight is calculated by viewers, not the simulator, so it will only work if there are other people nearby.<br />
<br />
Please understand that this is not a predictable or reliable figure, it can vary based on many different factors, and can suffer from random "surges" with apparently no cause. For this reason, we '''do not recommend''' that you enforce a render weight limit. However, the option is there if you require it.<br />
<br />
We've '''[https://jira.secondlife.com/browse/BUG-100791 opened a Jira ticket]''' to request script access to avatar complexity. Vote if you want this feature!<br />
<br />
= <span style="color:#00528c">'''Checklist for Automatically Ejecting Avatars '''</span> =<br />
# Is the Enforcer rezzed out by the land owner? <br />
# Is the enforcer ON the parcel? <br />
# If it is group land, is the Enforcer deeded to the group? <br />
# Is it multiple parcels - and is there one Enforcer PER PARCEL? <br />
# Did you configure an area? (The orb needs to know where to kick avatars FROM...) <br />
# Under Options > Disallow, did you turn "disallow by default" to '''ON'''?<br />
# Is the orb even armed? (You should see "disarm" in the popup menu if it IS armed) <br />
# Has the avatar to be ejected been standing still BEFORE you turned on "disallow by default"? Once the avatar moves, they will be seen and ejected. If they stand still and '''don't''' move, they won't be ejected yet. <br />
# Are you using '''only''' the "teleport home" option? (SL limitation: If the avatar does NOT have a home point set, or the home point no longer exists, the avatar cannot be "sent home".) <br />
<br />
=== Group Tag Issues ===<br />
----<br />
If you have the CasperSafe set to only allow group members, your group members '''MUST ALREADY''' be wearing the group tag when they teleport in. CasperSafe will not recognize if they change tags once they arrive - they'll have to tp out then back to get the orb to see the proper group.<br />
<br />
= <span style="color:#00528c">'''Visitor Tracking '''</span> =<br />
<br />
:* Visitor tracking turns ON or OFF using the options menu (so only Admins may turn this on or off.) <br />
:* Visitor data WILL be sent to CasperTech servers when turned on.<br />
:* When visitor tracking is enabled, the "VISITORS" button will change to "CNTRL PANEL" - click the control panel button to get a link for the web-based visitor stats.<br />
:* You must also '''[[CasperSafe_Security_Orb#Monitoring_Areas | define an area]]''' for the tracking to monitor before visitor tracking will actually take place<br />
:* Visitor tracking does '''not''' require land ownership. You can rent in a mall and still track your mall store visitors.<br />
<br />
=== Missing or Ghosted Visitors ===<br />
----<br />
Every time an avatar enters or leaves an area (and visitor tracking is turned on), the orb must send a message to CasperPanel to let it know. It is expected that - from time to time - one of these message may be lost/dropped, which will either cause a missing visitor, or a visitor remaining visible who has really already left. <br />
<br />
This is normal and expected, from time to time, however it shouldn't happen too often. If you are experiencing this problem very often, please contact '''[[CasperVend_2/Getting_Help#2.29_When_Casper_is_offline:_By_IM-to-Webform | CasperTech support]]''' since there may be something wrong that we need to look at. <br />
<br />
You can fix this by resetting your orb. Your "current visitors" list will also be cleared when the region restarts.<br />
<br />
= <span style="color:#00528c">'''CasperVend and CasperSafe'''</span> =<br />
There is NO linking process required to hook up CasperSafe with CasperVend - this is automatic behind the scenes. If you have visitor list enabled, you will see icons that represent repeat visits, and whether they bought something on that visit. <br />
<br />
= <span style="color:#00528c">'''Customising Your Orb'''</span> =<br />
The default CasperSafe Orb object has 1 prim and 2 faces: <br />
:* The main decorative texture with triangular shapes is face #0<br />
:* The "war is peace" strip is face #1<br />
:* The orb does '''NOT''' check for prim creator - you can use any object to put the scripts in<br />
<br />
=== Textures & Custom Objects ===<br />
----<br />
If you simply don't want the "war is peace" strip to change, there is a notecard in the shipping crate labeled '''DISABLE_TEXTURE_CHANGE''' - simply drop that in the orb's contents, and it will disable further color changes to that strip. <br />
<br />
Alternately, you can rez a simple prim sphere and copy all the contents of the orb to that - an unmodified legacy prim sphere has only face #0. <br />
<br />
'''NOTE:''' Currently, the "Disable texture change" does NOT change the texture animation. Please keep that in mind when making a custom object. <br />
<br />
=== Notifications ===<br />
----<br />
If you want the notifications for your staff to arrive as an object IM instead of a llRegionSay message (so they can potentially reach your staff when they are not in the sim/region) then simply drop the script labeled '''Optional Plugin: Send IMs to staff''' into the orb object, and it will do the rest. <br />
<br />
The optional plugin script is '''open source''' - therefore any changes you make to the script are '''your responsibility''', and are unsupported by CasperTech.<br />
<br />
==== Popup Menu Notifications ====<br />
----<br />
You cannot turn these off at this time, but that functionality is expected to be added in the next release.<br />
<br />
= <span style="color:#00528c">'''API Information'''</span> =<br />
<br />
Per Casper: <br />
'''We haven't yet published the API for CasperSafe.'''<br />
<br />
There is currently no date for when the API will be released. When it is released, it will be inserted into this space. If you are still seeing THIS message, the API information has not been released yet.<br />
<br />
= <span style="color:#00528c">'''Limitations'''</span> =<br />
:* No website configuration<br /> <i>All configuration of the orb itself is done inworld. While it stores minor configuration information online as a backup, it is designed to stay functional even if CasperTech web services have issues.</i><br />
:* Shift-drag-copy loses configuration<br /><i>The new copy will lose all configuration due to a new UUID created which has no record on the database. You may, however, '''take a copy''' of an orb with the desired configuration and rez as many additional copies of that as you please. </i><br />
:* Cannot filter visitor tracking by access level <br /><i>Access level of the avatar is not sent with the visit statistics. </i><br />
:* One orb per set of security settings<br /><i>While the orb can track multiple areas and parcels without an issue, it is only designed to hold ONE set of security settings. You cannot choose to eject people from one area while not ejecting them from another - you'll need multiple orbs. Yes, you can rez multiple orbs on a parcel and a sim/region. </i><br />
:* Land bans limited to the parcel the CasperSafe Enforcer is on<br /><i>llAddToLandBanList only works for the parcel the enforcer is currently on.</i><br />
:* One CasperSafe Enforcer per parcel<br /><i>If the land is group owned, the Enforcer unit will need to be deeded, using the same process as if you were '''[[CasperLet/Prim_Counter#How_to_Properly_Deed_a_Prim_Counter | deeding a prim counter.]]'''</i><br />
:* Deleting areas doesn't remove current visitors<br><i>If you delete an area, any avatars shown as currently visiting the area on the website will not be removed until the next time the orb is reset or the region is restarted.</i><br />
:* No avatar height restrictions<br /><i>CasperSafe does not support any sort of avatar height restriction. Since the introduction of mesh avatars, you can no longer depend on avatar height as being a psuedo-reliable indicator of the avatar's "age". There are many non-child avatars that are also short, and non-human avatars can come in many sizes as well. Height restrictions are therefore irrelevant today, and would eliminate too many '''legitimate''' avatars.</i><br />
:* No instant eject mode<br /><i>CasperSafe is designed to be fair to all. Security devices which are set to less than 10 seconds do not provide ample opportunity for passer-bys to vacate the area voluntarily - for the above reason, we don't support an "instant" eject mode. However, those who are on the "Ban" list '''will''' be ejected instantly.</i><br />
:* Cannot manually eject via the orb<br /><i>CasperSafe is only set up to eject in response to an allow prompt.</i><br />
<br />
= <span style="color:#00528c">'''Script Times'''</span> =<br />
<br />
These timings were measured over a 24 hour period, on a relatively quiet full region (Izanagi). Your mileage may vary, and times may be higher on busy sims.<br />
<br />
: UNARMED - 0.003ms<br />
: DISCREET - 0.003ms<br />
: ARMED - 0.004ms<br />
: LOCKDOWN - 0.005ms<br />
: ARMED + RADAR - 0.006ms<br />
: LOCKDOWN + RADAR - 0.007ms<br />
<br />
= <span style="color:#00528c">'''Error Messages'''</span> =<br />
: '''"Script asking non-owner for run time permissions only owner can grant" '''<br />
:: This is only referring to the scripted autoreturn permissions. They can only be granted by an OWNER in the land group. All other functions of the enforcer are unaffected by granting - or not granting - the autoreturn capability.<br />
<br />
:'''ChangeQueue is full! Too many events to send to the server!'''<br />
:: Casper needs to debug that. Please '''[[CasperVend_2/Getting_Help#2.29_When_Casper_is_offline:_By_IM-to-Webform_.28Preferred.29 | file a ticket]]''' and leave the orb out where Casper can access it.<br />
<br />
= <span style="color:#00528c">'''Troubleshooting / FAQ'''</span> =<br />
:'''Q. I'm seeing (one or more of) my managers get removed from the orb, but when I list the admins, they're still showing on the orb's list.'''<br />
::'''A.''' CasperSafe clears the list and re-adds them each time it is reset - this is part of the reset process. It is supposed to silence these messages, but sometimes (due to grid things) the messages are processed out of sequence and the remove message is processed before the silence message.</div>24607dde-d704-4db7-afa0-d9edc17c926chttps://wiki.casperdns.com/index.php?title=CasperSafe_Security_Orb&diff=14729CasperSafe Security Orb2021-07-01T21:34:11Z<p>24607dde-d704-4db7-afa0-d9edc17c926c: /* Warning Times */</p>
<hr />
<div>{|align=right<br />
|__TOC__<br />
|}<br />
<br />
{{Warning|Orb not ejecting? Please see the [[#Checklist_for_Automatically_Ejecting_Avatars|Checklist for Automatically Ejecting Avatars]], particularly the "Disallow by default" option. This is the most common support query for CasperSafe.}}<br />
<br />
= <span style="color:#00528c">'''About CasperSafe'''</span> =<br />
<br />
CasperSafe is a high-tech security and visitor tracking system. Its features include: <br />
<br />
* Self-contained configuration - no notecards<br />
* Fewer scripts than competing products - 4 instead of 11-13 scripts<br />
* CasperLet Support<br />
* Visitor Tracking option<br />
* Region-wide operation<br />
* Capable of monitoring many parcels at once<br />
<br />
{{Information|Depending on your viewer configuration (fonts, UI size, etc.) the length of the option names may not be identical to what's shown here. Popup menus shown here are from Viewer 3.}}<br />
<br />
= <span style="color:#00528c">'''What's in the Box?'''</span> =<br />
The following named items are in the shipping crate: <br />
:: CasperSafe Enforcer<br />
:: CasperSafe Parcel Link Tool<br />
:: CasperSafe Psychic Link Script (Read the instructions!) <br />
:: CasperSafe Security Orb<br />
<br />
Along with a landmark to the CasperTech store.<br />
<br />
= <span style="color:#00528c">'''What's with the 'war is peace' stuff?'''</span> =<br />
<br />
The orb has been themed in several ways with tongue-in-cheek references to George Orwell's 1984, a novel about totalitarian control, monitoring and mind control. It's not a political statement, just a cultural reference.<br />
<br />
= <span style="color:#00528c">'''Quick Setup Steps'''</span> =<br />
:# Rez the shipping crate and unpack<br />
:# Rez out the CasperSafe Security Orb<br />
:# '''[[CasperSafe_Security_Orb#Add_Areas | Add areas]]''' and/or '''[[CasperSafe_Security_Orb#Link_to_Rental_Unit | link to rental unit]]'''<br />
:# Rez (and deed if necessary) the '''[[CasperSafe_Security_Orb#CasperSafe_Enforcer | Enforcer unit]]'''<br />
:# Add people to appropriate '''[[CasperSafe_Security_Orb#Access_Levels | access lists]]'''<br />
:# Arm the orb<br />
<br />
See the sections below for explanations of all the options.<br />
<br />
= <span style="color:#00528c">'''Configuration Tips'''</span> =<br />
<br />
CasperSafe will save its configuration on the server. Like CasperLet and SimpleSit, this is saves the information against the UUID of the device, barring a complete script reset (which makes it forget everything) or shift-drag-copy (the copy that is left behind has both reset the script AND has a new UUID and thus no old configuration.) <br />
<br />
:* Takes about 20-30 seconds to save configuration changes. <br />
:* Configuration is kept when you "Take a copy" '''then''' Rez the copy<br />
:* Configuration is '''NOT''' kept when you shift > drag > copy (this resets the script) <br />
:* Like CasperLet, the script tracks the UUID of the device. New device = new UUID, thus shift > drag > copy = New device and new UUID. <br />
:* Information will NOT transfer between two unrelated or different version orbs. (This would be a hassle for landlords, where different orbs are expected to have different individual configurations depending on the renter.)<br />
:* When used with CasperLet, the owner and any CasperLet managers are automatically admins<br />
:* When used with CasperLet, the primary tenant + additional subtenants on that rental are added automatically to the SUBADMIN access list. <br />
<br />
CasperSafe is '''not''' meant to be configured via the website - while this may make it less convenient, this does ensure that it continues to function despite any website outage.<br />
<br />
=== Checking Version Number ===<br />
----<br />
Because the UpgradeBee does '''NOT''' rename the object, if you wish to verify that your orb(s) have been updated, you will need to edit > contents tab > right-click on one of the scripts > select "Properties" > check the version number in the description field. See the '''[[Current_Versions | versions page]]''' for current version number and changelog information.<br />
<br />
= <span style="color:#00528c">'''Security Settings & Levels'''</span> =<br />
<br />
== '''Access Levels''' ==<br />
<br />
When Admins click into the access menu, they will get the following options: <br />
{| <br />
| [[File:CasperSafe - Access - Main.png|350px|thumb|left|Access main menu - click to see larger version.]]<br />
|}<br />
<br />
When Subadmins click into the access menu, their options will be a little different: <br />
{| <br />
| [[File:CasperSafe_-_Subadmin_-_Access_Version.png|350px|thumb|left|Subadmin version of access menu - click to see larger version.]]<br />
|}<br />
<br />
== '''Access Level Chart''' ==<br />
<br />
{| class="wikitable"<br />
|-<br />
! Main Menu Option<br />
! Guests<br />
! SubAdmins<br />
! Admins<br />
|-<br />
| Areas <br />
| No<br />
| No<br />
| Yes<br />
|-<br />
| Arm / Disarm<br />
| No<br />
| Yes<br />
| Yes<br />
|-<br />
| Lockdown<br />
| No<br />
| Yes<br />
| Yes<br />
|-<br />
| Link / Unlink (rental units)<br />
| No<br />
| No<br />
| Yes<br />
|-<br />
| Access Menu<br />
| No<br />
| Yes (subadmins / guests / ban list)<br />
| Yes<br />
|-<br />
| Options<br />
| No<br />
| No<br />
| Yes<br />
|-<br />
| Visitor Control Panel<br />
| No<br />
| Yes, no sales<br />
| Yes, with sales<br />
|}<br />
<br />
: '''Admins:''' This is the owner, plus any additional designated avatars added to the orb's Admin list. <br />
: '''SubAdmins:''' Usually subadmins are the tenants of a landlord. As a result, they will not have access to the options list or other higher administrative functions of the orb. <br />
: '''Guest:''' This option allows you to add a mostly permanent "whitelist" of allowed guests. Guest level does '''not''' come with menu access to the orb. <br />
: '''Temporary:''' Like the "Guest" level, except that people added to the temporary list are automatically removed after they leave the sim/region. <br />
: '''Banned:''' This option allows you to add to a list of "never allowed" avatars. Anyone on the ban list will automatically be ejected/teleported home (provided they HAVE a home point set...) upon arrival, if ejection is on and an enforcer is out (and properly deeded if necessary.) <br />
<br />
=== Security Notes ===<br />
----<br />
Each CasperSafe can only hold '''one''' set of security options. <br />
<br />
If you need to have different security settings for different areas, then you'll need one orb per set of security settings. <br />
<br />
Yes, you can rez multiple orbs on the same sim/region.<br />
<br />
:* When used with CasperLet, the owner and any CasperLet managers are automatically admins<br />
:* When used with CasperLet, the primary tenant + additional subtenants on that rental are added automatically to the SUBADMIN access list. <br />
:* Two CasperTech support avatars are added to the whitelist to make it easier to provide any needed support: Casper Warden and CasperHelp Resident.<br />
:* Lockdown mode automatically ends when the entire sim is empty of all allowed avatars.<br />
<br />
== '''Warning Times''' ==<br />
Minimum warning time of 10 seconds (default setting of 30 seconds). <br />
<br />
Lockdown mode warning time of explicitly 00 seconds (instantly ejected), regardless of normal warning time setting. Lockdown mode ends automatically when all allowed avatars leave the sim/region. <br />
<br />
There is no "instant eject" '''unless''' the avatar is explicitly on the orb's ban list.<br />
<br />
=== Ejected without warning? ===<br />
----<br />
CasperSafe '''always''' sends a warning first, before ejecting (when ejecting is properly configured.) <br />
<br />
The times a visitor may not see the warning are: <br />
: 1) If they muted the orb<br />
: 2) If what they think was CasperSafe is actually a neighbour's non-CasperTech orb set to the wrong distance. <br />
<br />
Visitors normally receive a notice, either by popup or by local chat, indicating what they were ejected by.<br />
<br />
== '''CasperSafe Enforcer''' ==<br />
<br />
{{Warning|The CasperSafe Enforcer may ask for permission to return objects. Objects will ONLY be returned IF permissions are granted AND the option to return prims is enabled on the CasperSafe Orb. If activated, the orb will return prims belonging to an avatar when they are '''ejected'''. '''BE CAREFUL''' with this option - we accept no responsibility for any damage caused.}}<br />
<br />
This is the widget that actually does the ejecting / teleport home functions. Thus it is required if you actually want to be able to boot avatars out of the protected area - Otherwise CasperSafe operates in "Warning Mode" which basically nags the avatars instead. <br />
<br />
Like the '''[[CasperLet/Prim_Counter#Prim_Counter_Basics | CasperLet Prim Counter]]''', in order to function properly, the Enforcer widget must be owned by the LAND OWNER. If the land is owned by an individual, that individual must REZ the Enforcer widget. If the land is owned by a group, the Enforcer must be REZZED by an individual with the same group tag as the parcel, and they must then DEED the Enforcer to the group. If there are multiple land owners, then you will need one Enforcer per land owner.<br />
<br />
The permissions of the Enforcer widget are copy & transfer so that it can be deeded to the appropriate land owners.<br />
<br />
{{Critical|For security reasons, the enforcer will only respond to CasperSafe orbs belonging to its '''owner''', or in the case of the enforcer being deeded to group, orbs belonging to the either '''the owner or the previous owner''' (because the land owner isn't always the orb owner.) }}<br />
<br />
'''UPDATES:''' The enforcer only needs to be replaced when a new enforcer version goes out.<br />
<br />
=== Using Enforcer On Group Land Where You're Only Renting ===<br />
----<br />
:# Rez the enforcer - this sets a "bit" so that it know you're the original owner<br />
:# Rename it so you can find it in your inventory<br />
:# Pick up the enforcer<br />
:# Pass THAT copy of the enforcer to your landlord, so THEY can rez it out<br />
:# Landlord will need to deed the enforcer to the group (if group owned land)<br />
<br />
Do '''NOT''' pass over a fresh one that you haven't rezzed first, because it will NOT recognize instructions from your CasperSafe orb.<br />
<br />
=== Enforcer Must Stay Rezzed ===<br />
----<br />
The enforcer will not be able to eject avatars if it is only in your inventory, so yes, the enforcer '''must stay rezzed.''' <br />
<br />
=== One Enforcer Per Parcel ===<br />
----<br />
You only need one (1) enforcer '''per parcel''' - see the '''[[CasperLet/Prim_Counter#Sample_Land_Configurations | prim counter]]''' page for rezzing, when when you have to deed. <br />
<br />
The enforcer will turn all black when it is '''properly''' deeded or rezzed - this is normal and does NOT mean it's broken.<br />
<br />
=== Enforcer and Autoreturn ===<br />
----<br />
If you want the enforcer to utilize autoreturn, you must: <br />
<br />
:# Rez the CasperSafe orb '''first'''. <br />
:# Set up the autoreturn options in settings<br />
:# '''Then''' rez and deed the enforcer.<br />
<br />
=== Enforcer, Group Detection, Autreturn and You ===<br />
----<br />
If you are using '''group detection''', it is '''highly recommended''' that you '''do NOT''' use the object return feature, because people will always forget their group tag, and having object return on may result in an individual having their objects returned.<br />
<br />
= '''<span style="color:#00528c">Land Configuration - When Security Is Required</span>''' =<br />
All examples are on a '''per-region''' basis, and the Enforcer is '''ONLY''' required when you need security on an area in a parcel. If you are simply using it for visitor tracking, no enforcer is needed. <br />
<br />
Even if you have multiple CasperSafes on a parcel for different security settings, you only need ONE Enforcer per parcel. <br />
<br />
The CasperSafe Enforcer cannot operate across sim boundaries; you will need to repeat the appropriate steps for each sim/region that you have. <br />
<br />
{| class="wikitable" <br />
|-<br />
! style="white-space: nowrap; background: #33CCFF; border: 2px solid #383838;" | Land Owners On Sim/Region<br />
! style="white-space: nowrap; background: #33CCFF; border: 2px solid #383838;" | Actions To Take With CasperSafe Enforcer<br />
|-<br />
| Shared land, one parcel <br />Owned by YOU<br />
| <br />
# Rez '''one''' CasperSafe Enforcer, on land YOU own<br />
# No deeding required - just rez and wait<br />
# Repeat on each additional sim/region you have<br />
|-<br />
| Shared land, one parcel <br />Owned by ONE other avatar<br />
| <br />
# Transfer the CasperSafe Enforcer to THAT avatar<br />
# THEY must rez out ONE CasperSafe Enforcer on land owned by THEM<br />
# No deeding required - just rez<br />
# Repeat on each additional sim/region you have<br />
|-<br />
| Shared land, one parcel <br />Owned by ONE land group<br />
| <br />
# Rez out ONE CasperSafe Enforcer on land owned by that group<br />
# Right-Click > Edit > "Share with group" > "Deed"<br />
# Repeat on each additional sim/region you have<br />
|-<br />
| Shared land, multiple parcels <br />Some owned by YOU<br />Some by ONE land group<br />
| <br />
# Rez out one CasperSafe Enforcer on EACH group-owned parcel<br />
# Right-Click > Edit > "Share with group" > "Deed"<br />
# Rez out one CasperSafe Enforcer on EACH parcel owned by you<br />
# No deeding required on the land YOU own - just rez<br />
# Repeat on each additional sim/region you have<br />
|-<br />
| Shared land, multiple parcels <br />Owned by MULTIPLE land groups<br />
| <br />
# Rez one CasperSafe Enforcer PER land group, PER parcel<br />
# Right-Click > Edit > "Share with group" > "Deed"<br />
# Repeat on each additional sim/region you have<br />
|}<br />
<br />
= <span style="color:#00528c">'''Monitoring Areas'''</span> =<br />
Avatars are tracked by the area they're in. If an avatar is registered as entering two areas '''at the same time''' that have identical names, the system will end the first visit to avoid duplicates. <br />
<br />
Please ensure each area that is defined has its own unique name to avoid this! <br />
<br />
== Automatic Settings ==<br />
: * When used with CasperLet, the owner and any CasperLet managers are added automatically to the ADMIN access list. <br />
: * When used with CasperLet, the primary tenant + additional subtenants on that rental are added automatically to the SUBADMIN access list. <br />
: * Lockdown mode automatically ends when the sim/region is empty of all allowed avatars.<br />
<br />
=== Note for Skyboxes ===<br />
----<br />
<br />
If you only want to monitor an area NEAR a skybox, set the orb to monitor a '''range''' instead of the parcel. Parcel will assume you want to keep watch over all of the parcel, from "floor to ceiling".<br />
<br />
== Custom Areas ==<br />
'''Custom Areas: Suitable for odd shaped parcels, or a specific square/rectangular size within a parcel - Limited only by available memory'''<br />
<br />
:* Click for menu<br />
:* Select "Areas" <br />
:* Select "Add" <br />
:* Select "Custom" <br />
:* Corner markers will appear<br />
:* Drag the lower marker to the lowest corner of the area you want to monitor<br />
:* Drag the upper marker to the uppermost corner of the area you want to monitor<br />
:* Click one of the markers<br />
:* Select Save<br />
:* Name the area<br />
:* Done! <br />
<br />
If you accidentally manually delete one marker, the corresponding one will self-delete as well.<br />
<br />
==== Custom Area Issues ====<br />
----<br />
:# "Object Entry" '''must be allowed''' for ALL parcels you are dragging custom markers across.<br />
:# Parcels with autoreturn '''must''' give you enough time to do what you need to do before it will send them back. (You can always set autoreturn back to 1 when you're done.) <br />
<br />
Otherwise you'll see things like particles flying completely out of the parcel, and custom area markers/nodes being automatically returned.<br />
<br />
== Custom Range Radius ==<br />
'''Custom Ranges: Number limited only by amount of available memory in the orb.'''<br />
<br />
To set a custom area: <br />
<br />
:* Click the orb<br />
:* Select "Areas" <br />
:* Select "Add" <br />
:* Select "Range" <br />
:* Enter in the detection range, in meters, and click "Send" <br />
:* Enter name of the area, and click "Send" <br />
:* Done!<br />
<br />
Range = Radius. &nbsp;&nbsp;'''''[https://en.wikipedia.org/wiki/Radius What is a radius?]'''''<br />
<br />
== Parcel Link ==<br />
'''Number of Parcels: Limited only by amount of available memory in the orb.'''<br />
<br />
The Parcel Link Tool allows CasperSafe to be paired with one or more parcels. The Parcel Link Tool must be '''used''' on the parcel that will be linked to the CasperSafe orb, and '''ONLY''' by the owner of the orb. (Admins and subadmins cannot add a parcel using the Parcel Link Tool because the Tool is no-transfer.) This may be rezzed on any parcel and moved over, just be sure to allow a minute or two for it to pick up the change in parcels. <br />
<br />
: '''1)''' Rez the CasperSafe Security Orb on the land you want it to monitor<br />
: '''2)''' Rez the "Parcel Link Tool" - You will get these messages in local chat: <br />
Touch me to pair this parcel with your CasperSafe orb. <br />
Make sure you have started pairing on the orb by choosing AREA -> ADD -> PARCEL, first.<br />
I'm now over parcel ''((parcel name as seen in "about land" floater))''. Touch to register with a CasperSafe Orb.<br />
: '''3)''' On the CasperSafe orb, click for the popup menu<br />
: '''4)''' Select "Areas" <br />
: '''5)''' Select "Add" <br />
: '''5)''' Select "Parcel" <br />
: '''6)''' Then click the Parcel Link Tool. You'll see the following messages in local chat: <br />
OK. Trying to find a CasperSafe orb, please stand by.<br />
Alright, all done!<br />
Pairing process ended.<br />
: '''7)''' The Parcel Link Tool will self-delete when the parcel pairing process is completed. <br />
<br />
Pairing process usually takes 1-2 minutes, but may be longer if the region is heavily lagged.<br />
<br />
== Rental Unit Pairing ==<br />
=== '''Ownership''' ===<br />
----<br />
Rental unit AND the CasperSafe orb '''must''' be owned by the same avatar. This is for security reasons. (If anyone could do this, then anyone could control your security orb without your knowledge or permission.) <br />
<br />
=== '''Pairing Process''' ===<br />
----<br />
<br />
'''Pairing limit: 1 rental unit per orb'''<br />
<br />
'''NOTE:''' CasperSafe may be paired with only ONE rental unit. If you have multiple rental units out, AND you want to pair CasperSafe to the units, you'll need one CasperSafe per unit. <br />
<br />
: '''1)''' Rez CasperSafe Security Orb near the rental unit<br />
: '''2)''' Click CasperSafe for the main menu<br />
{| <br />
| [[File:CasperSafe_-_Main_Menu_-_Unarmed.png|350px|thumb|left|Default main menu - click to see larger version.]]<br />
|}<br />
: '''3)''' Select "LINK". You'll get a popup with instructions: <br />
{| <br />
| [[File:CasperSafe - Link Menu.png|350px|thumb|left|Default main menu - click to see larger version.]]<br />
|}<br />
: '''4)''' Drop the "Psychic Link Script" into the corresponding rental unit<br />
: '''5)''' Watch messages in local chat. If all goes well, you should see: <br />
Okay, let's have a look here..<br />
Ooh, CasperLet! Good choice! Searching for the orb..<br />
Cool! I'm paired with ''((name of rental unit))'' (Key: ''((uuid string))'' )<br />
Pairing process ended. <br />
: '''6)''' The orb will also add the CasperSafe system owner as an ADMIN automatically. <br />
<br />
Pairing process usually takes 1-2 minutes, but may be longer if the region is heavily lagged.<br />
<br />
=== CasperLet Manager Auto-Update Timing ===<br />
----<br />
<br />
CasperSafe will automatically pick up changes to CasperLet managers, '''HOWEVER''' it is not instant - It will take time to filter through, and will be the next time the rental unit updates info to/from the server.<br />
<br />
= <span style="color:#00528c">'''Main Menus'''</span> =<br />
<br />
=== Main Menu for Admins ===<br />
----<br />
<br />
By default, when you first rez out CasperSafe, the orb is in the "unarmed" state. When unarmed, the orb automatically runs in "discreet mode" in order to be kinder to region resources. <br />
{| <br />
| [[File:CasperSafe_-_Main_Menu_-_Unarmed.png|350px|thumb|left|Default main menu - click to see larger version.]]<br />
|}<br />
<br />
When you choose to arm the orb, you will also have an extra "lockdown" option, as shown here: <br />
{| <br />
| [[File:CasperSafe - Main Menu - Armed Mode.png |350px|thumb|left|Armed mode - click to see larger version.]]<br />
|}<br />
When CasperSafe is armed, the base menu will also show the option "Lockdown" - this changes the warning time to 10 seconds (reduced from the normal minimum of 20 seconds), and increases the scan frequency in order to detect possible threats more quickly.<br />
<br />
Also, when someone arrives who is not on any of the access lists, admins will get a popup asking them if they want to add the new arrival on a temporary or guest basis, or whether to ban. <br />
<br />
=== Main Menu for SubAdmins ===<br />
----<br />
Subadmins will typically be tenants of a landlord, and will not have administrator access to the higher functions of the security orb; they will only have access to the following menu items: <br />
:* Access list (to add fellow subadmins, guests and temporary guests) <br />
:* Arm/Disarm/Lockdown<br />
:* Visitor stats (if enabled)<br />
<br />
=== About Lockdown mode===<br />
----<br />
If the orb is currently '''in''' "lockdown" mode, the lockdown option will change to "stand down". <br />
<br />
This automatically disables itself when everyone ON the access list has left the sim/region - there is no time limit beyond that. <br />
<br />
Lockdown mode changes the warning time to 10 seconds (from the normal minimum of 20), and uses slightly more script time than normal operation (see '''[[CasperSafe_Security_Orb#Script_Times | Script Times]]''' for details) in order to detect possible intrusions faster.<br />
<br />
= <span style="color:#00528c">'''Security Menus'''</span> =<br />
<br />
=== '''Configuration Options Menus''' ===<br />
----<br />
These are the default settings for the options menu, as it ships from CasperTech: <br />
{| <br />
| [[File:CS_Config_Options_Page_1.png|350px|thumb|left|Default Options page 1 - click to see larger version.]] | [[File:CS_Config_Options_Page_2.png|350px|thumb|left|Default Options page 2- click to see larger version.]]<br />
|}<br />
<br />
== '''Configuration Options Explanations''' ==<br />
<br />
{| class="wikitable"<br />
|-<br />
! Options Items<br />
! What it does<br />
|-<br />
| Floating Text<br />
| This turns the radar on and off. Having the radar on will use more script time and processing. <br />
|-<br />
| Disallow by default<br />
| When on, this will eject anyone who's not on the access list. <br />
|-<br />
| Discreet mode<br />
| When on, this slows down the timers to reduce lag. It won't be as responsive, but it will be kinder to region resources. <br />
|-<br />
| Eject from parcel <br />
| When on, this will eject unwanted visitors after the warning period has ended. <br />
|-<br />
| Teleport Home<br />
| When on, this will teleport unwanted visitors to their home point. <br />
|-<br />
| Add to parcel ban list<br />
| When on, this will add ejected avatars to the parcel's land ban list (not the ban list in the orb). <br />
|-<br />
| Warning Time<br />
| This controls how long the avatar can stay before being ejected, if eject mode is on. In "Warning mode" (which is the default, if there is no Enforcer present and/or properly deeded) this is how long before CasperSafe sends another warning to the intruding avatar. The shipped default is 30 seconds, and may be reduced to 20 seconds for normal operation. When in lockdown mode, the warning time is hard-set at 10 seconds. <br />
|-<br />
| Age Limit<br />
| When on, you configure the minimum number of days of account age before avatars are allowed in to the protected area. <br />
|-<br />
| Script Limit<br />
| When on, you configure the maximum amount of scripts an avatar may be wearing/using before they are allowed in to the protected area. <br />
|-<br />
| Visitor Tracking<br />
| When on, this tracks visitors and sends visitor data to the CasperTech website. Visitors cannot (currently) be filtered by admin/subadmin/guest levels; access list data is not sent to the website. You must have an '''[[CasperSafe_Security_Orb#Monitoring_Areas | area defined]]''' before tracking will actually take place. (The orb needs to know where to keep watch.) <br />
|-<br />
| Group members are guests<br />
| When on, allows members of the group the orb is rezzed under into the protected area. "Guest" access does not include any part of orb menus. <br />
|-<br />
| Group members are subadmins<br />
| When on, allows members of the group the orb is rezzed under both into the protected area '''and''' gives them subadmin access to the orb itself. <br />
|-<br />
| Limit detection to current parcel<br />
| When on, this limits detection ranges to within the borders of the parcel the orb is rezzed on. This prevents things like the orb's ejecting/banning from affecting users on other (unrelated) parcels. <br />
|-<br />
| Return prims when ejected<br />
| When on, uses the scripted prim autoreturn feature. This is not recommended in combination with group detection, because people often forget their group tag when they try to rez objects. <br />
|-<br />
| Don't send notifications to admins <br />
| When on, this prevents the orb from sending notifications to users on the "Admin" access level. By default, all messages are delivered via llRegionSay to prevent IM's from capping while you are offline. (If IM notifications are prefered, there is an optional script in the orb's shipping crate that will do this.) <br />
|-<br />
| Don't send notifications to subadmins<br />
| When on, this prevents the orb from sending notifications to users on the "SubAdmin" access level. By default, all messages are delivered via llRegionSay to prevent IM's from capping while you are offline. (If IM notifications are prefered, there is an optional script in the orb's shipping crate that will do this.)<br />
|-<br />
| Send notifications to guests<br />
| When on, this will send notifications to users on the "Guest" access level. By default they don't receive notifications. <br />
|-<br />
| No-Fly Zone<br />
| When on, the flying avatar is warned. If "Eject" is on, then the user is ejected from the area. If "Teleport Home" is on, then the user is teleported home. There is no height limit on flight detection. <br />
|-<br />
| Render Weight Limit<br />
| When on, you set the maximum avatar complexity that individual avatars should be at. Users above that point will be warned. If "Eject" is on, then the user is ejected from the area. If "Teleport Home" is on, then the user is teleported home. <br />
|}<br />
<br />
=== Memory Limits ===<br />
----<br />
Data about names for Admin/Subadmin/Guest lists are stored IN the device. Consequently every name that's added will cause the available memory to decrease, and it will give you a local chat message indicating how much memory is left. Once the available memory gets below a certain point (somewhere around 300 names), the orb will crash - so it's up to you to keep an eye on how much memory is being used. <br />
<br />
You CAN rez multiple orbs if you are getting low in memory on the first one.<br />
<br />
= <span style="color:#00528c">'''Render Weight'''</span> =<br />
<br />
The CasperSafe orb has the ability to eject avatars if their render weight (ARC) is too high. However, please be aware that:<br />
<br />
* It is '''not the same thing''' as avatar complexity, but represents the same thing.<br />
* It has a maximum value of 500,000. If you set your limit higher than this, it'll have no effect.<br />
* A render weight of 500,000 is '''roughly''' equivalent to an avatar complexity of 1 million.<br />
* Render weight is calculated by viewers, not the simulator, so it will only work if there are other people nearby.<br />
<br />
Please understand that this is not a predictable or reliable figure, it can vary based on many different factors, and can suffer from random "surges" with apparently no cause. For this reason, we '''do not recommend''' that you enforce a render weight limit. However, the option is there if you require it.<br />
<br />
We've '''[https://jira.secondlife.com/browse/BUG-100791 opened a Jira ticket]''' to request script access to avatar complexity. Vote if you want this feature!<br />
<br />
= <span style="color:#00528c">'''Checklist for Automatically Ejecting Avatars '''</span> =<br />
# Is the Enforcer rezzed out by the land owner? <br />
# Is the enforcer ON the parcel? <br />
# If it is group land, is the Enforcer deeded to the group? <br />
# Is it multiple parcels - and is there one Enforcer PER PARCEL? <br />
# Did you configure an area? (The orb needs to know where to kick avatars FROM...) <br />
# Under Options > Disallow, did you turn "disallow by default" to '''ON'''?<br />
# Is the orb even armed? (You should see "disarm" in the popup menu if it IS armed) <br />
# Has the avatar to be ejected been standing still BEFORE you turned on "disallow by default"? Once the avatar moves, they will be seen and ejected. If they stand still and '''don't''' move, they won't be ejected yet. <br />
# Are you using '''only''' the "teleport home" option? (SL limitation: If the avatar does NOT have a home point set, or the home point no longer exists, the avatar cannot be "sent home".) <br />
<br />
=== Group Tag Issues ===<br />
----<br />
If you have the CasperSafe set to only allow group members, your group members '''MUST ALREADY''' be wearing the group tag when they teleport in. CasperSafe will not recognize if they change tags once they arrive - they'll have to tp out then back to get the orb to see the proper group.<br />
<br />
= <span style="color:#00528c">'''Visitor Tracking '''</span> =<br />
<br />
:* Visitor tracking turns ON or OFF using the options menu (so only Admins may turn this on or off.) <br />
:* Visitor data WILL be sent to CasperTech servers when turned on.<br />
:* When visitor tracking is enabled, the "VISITORS" button will change to "CNTRL PANEL" - click the control panel button to get a link for the web-based visitor stats.<br />
:* You must also '''[[CasperSafe_Security_Orb#Monitoring_Areas | define an area]]''' for the tracking to monitor before visitor tracking will actually take place<br />
:* Visitor tracking does '''not''' require land ownership. You can rent in a mall and still track your mall store visitors.<br />
<br />
=== Missing or Ghosted Visitors ===<br />
----<br />
Every time an avatar enters or leaves an area (and visitor tracking is turned on), the orb must send a message to CasperPanel to let it know. It is expected that - from time to time - one of these message may be lost/dropped, which will either cause a missing visitor, or a visitor remaining visible who has really already left. <br />
<br />
This is normal and expected, from time to time, however it shouldn't happen too often. If you are experiencing this problem very often, please contact '''[[CasperVend_2/Getting_Help#2.29_When_Casper_is_offline:_By_IM-to-Webform | CasperTech support]]''' since there may be something wrong that we need to look at. <br />
<br />
You can fix this by resetting your orb. Your "current visitors" list will also be cleared when the region restarts.<br />
<br />
= <span style="color:#00528c">'''CasperVend and CasperSafe'''</span> =<br />
There is NO linking process required to hook up CasperSafe with CasperVend - this is automatic behind the scenes. If you have visitor list enabled, you will see icons that represent repeat visits, and whether they bought something on that visit. <br />
<br />
= <span style="color:#00528c">'''Customising Your Orb'''</span> =<br />
The default CasperSafe Orb object has 1 prim and 2 faces: <br />
:* The main decorative texture with triangular shapes is face #0<br />
:* The "war is peace" strip is face #1<br />
:* The orb does '''NOT''' check for prim creator - you can use any object to put the scripts in<br />
<br />
=== Textures & Custom Objects ===<br />
----<br />
If you simply don't want the "war is peace" strip to change, there is a notecard in the shipping crate labeled '''DISABLE_TEXTURE_CHANGE''' - simply drop that in the orb's contents, and it will disable further color changes to that strip. <br />
<br />
Alternately, you can rez a simple prim sphere and copy all the contents of the orb to that - an unmodified legacy prim sphere has only face #0. <br />
<br />
'''NOTE:''' Currently, the "Disable texture change" does NOT change the texture animation. Please keep that in mind when making a custom object. <br />
<br />
=== Notifications ===<br />
----<br />
If you want the notifications for your staff to arrive as an object IM instead of a llRegionSay message (so they can potentially reach your staff when they are not in the sim/region) then simply drop the script labeled '''Optional Plugin: Send IMs to staff''' into the orb object, and it will do the rest. <br />
<br />
The optional plugin script is '''open source''' - therefore any changes you make to the script are '''your responsibility''', and are unsupported by CasperTech.<br />
<br />
==== Popup Menu Notifications ====<br />
----<br />
You cannot turn these off at this time, but that functionality is expected to be added in the next release.<br />
<br />
= <span style="color:#00528c">'''API Information'''</span> =<br />
<br />
Per Casper: <br />
'''We haven't yet published the API for CasperSafe.'''<br />
<br />
There is currently no date for when the API will be released. When it is released, it will be inserted into this space. If you are still seeing THIS message, the API information has not been released yet.<br />
<br />
= <span style="color:#00528c">'''Limitations'''</span> =<br />
:* No website configuration<br /> <i>All configuration of the orb itself is done inworld. While it stores minor configuration information online as a backup, it is designed to stay functional even if CasperTech web services have issues.</i><br />
:* Shift-drag-copy loses configuration<br /><i>The new copy will lose all configuration due to a new UUID created which has no record on the database. You may, however, '''take a copy''' of an orb with the desired configuration and rez as many additional copies of that as you please. </i><br />
:* Cannot filter visitor tracking by access level <br /><i>Access level of the avatar is not sent with the visit statistics. </i><br />
:* One orb per set of security settings<br /><i>While the orb can track multiple areas and parcels without an issue, it is only designed to hold ONE set of security settings. You cannot choose to eject people from one area while not ejecting them from another - you'll need multiple orbs. Yes, you can rez multiple orbs on a parcel and a sim/region. </i><br />
:* Land bans limited to the parcel the CasperSafe Enforcer is on<br /><i>llAddToLandBanList only works for the parcel the enforcer is currently on.</i><br />
:* One CasperSafe Enforcer per parcel<br /><i>If the land is group owned, the Enforcer unit will need to be deeded, using the same process as if you were '''[[CasperLet/Prim_Counter#How_to_Properly_Deed_a_Prim_Counter | deeding a prim counter.]]'''</i><br />
:* Deleting areas doesn't remove current visitors<br><i>If you delete an area, any avatars shown as currently visiting the area on the website will not be removed until the next time the orb is reset or the region is restarted.</i><br />
:* No avatar height restrictions<br /><i>CasperSafe does not support any sort of avatar height restriction. Since the introduction of mesh avatars, you can no longer depend on avatar height as being a psuedo-reliable indicator of the avatar's "age". There are many non-child avatars that are also short, and non-human avatars can come in many sizes as well. Height restrictions are therefore irrelevant today, and would eliminate too many '''legitimate''' avatars.</i><br />
:* No instant eject mode<br /><i>CasperSafe is designed to be fair to all. Security devices which are set to less than 10 seconds do not provide ample opportunity for passer-bys to vacate the area voluntarily - for the above reason, we don't support an "instant" eject mode. However, those who are on the "Ban" list '''will''' be ejected instantly.</i><br />
:* Cannot manually eject via the orb<br /><i>CasperSafe is only set up to eject in response to an allow prompt.</i><br />
<br />
= <span style="color:#00528c">'''Script Times'''</span> =<br />
<br />
These timings were measured over a 24 hour period, on a relatively quiet full region (Izanagi). Your mileage may vary, and times may be higher on busy sims.<br />
<br />
: UNARMED - 0.003ms<br />
: DISCREET - 0.003ms<br />
: ARMED - 0.004ms<br />
: LOCKDOWN - 0.005ms<br />
: ARMED + RADAR - 0.006ms<br />
: LOCKDOWN + RADAR - 0.007ms<br />
<br />
= <span style="color:#00528c">'''Error Messages'''</span> =<br />
: '''"Script asking non-owner for run time permissions only owner can grant" '''<br />
:: This is only referring to the scripted autoreturn permissions. They can only be granted by an OWNER in the land group. All other functions of the enforcer are unaffected by granting - or not granting - the autoreturn capability.<br />
<br />
:'''ChangeQueue is full! Too many events to send to the server!'''<br />
:: Casper needs to debug that. Please '''[[CasperVend_2/Getting_Help#2.29_When_Casper_is_offline:_By_IM-to-Webform_.28Preferred.29 | file a ticket]]''' and leave the orb out where Casper can access it.<br />
<br />
= <span style="color:#00528c">'''Troubleshooting / FAQ'''</span> =<br />
:'''Q. I'm seeing (one or more of) my managers get removed from the orb, but when I list the admins, they're still showing on the orb's list.'''<br />
::'''A.''' CasperSafe clears the list and re-adds them each time it is reset - this is part of the reset process. It is supposed to silence these messages, but sometimes (due to grid things) the messages are processed out of sequence and the remove message is processed before the silence message.</div>24607dde-d704-4db7-afa0-d9edc17c926chttps://wiki.casperdns.com/index.php?title=Passwords_CasperLet&diff=14587Passwords CasperLet2021-05-07T17:46:35Z<p>24607dde-d704-4db7-afa0-d9edc17c926c: /* Creating Your CasperDNS.com Account */</p>
<hr />
<div>{|align=right<br />
|__TOC__<br />
|}<br />
[[File:German_flag.gif]] [[Passwords_CasperLet/DE | Schaue hier in Deutsch!]]<br />
<br />
<br />
= '''<span style="color:#00528c">Important Reminder</span>''' =<br />
{{Warning|IMPORTANT: For your own security, please do not use the same password that you use in any other vending systems, or in Second Life. Doing so runs the risk of multiple points of malicious compromise if someone manages to figure out your password.}}<br />
<br />
<br />
== '''<span style="color:#00528c">Creating Your CasperDNS.com Account</span>''' ==<br />
<br />
<br />
If you have trouble coming up with a secure password on your own, you can use the '''[https://www.grc.com/passwords.htm Gibson Research High Security Password Generator]'''. If you need a "password keeper" utility on windows, you can try '''[http://passwordsafe.sourceforge.net/ Password Safe]'''<br />
<br />
<ol><li>Go to the '''[https://let.casperdns.com/ CasperDNS Login Page]'''. You will arrive at what looks like a login prompt. Don't panic, just keep following the instructions.</li><br />
<li>Enter your username. Your CasperDNS username does not have to match your inworld avatar account name, but some folk find it easier if it does. CasperLet account names can not be changed, so make sure you use something you will be happy with.</li><br />
<li>Enter your desired password (your password should be UNIQUE and not used anywhere else, '''again, do not use the same password that you use in any other vending / rental systems, or in Second Life'''.) and click ok. You'll be taken to a new screen.</li><br />
<li>Enter your email address, the same password again, and click ok.</li><br />
<li>You'll be presented with the CasperDNS front page. You are now logged in to CasperDNS at this point and can now do things in CasperLet (if you have rental units, or are a manager on someone else's CasperLet units).</li><br />
</ol><br />
<br />
== '''<span style="color:#00528c">Password Reset (when you don't remember your password)</span>''' ==<br />
<br />
<ol><br />
<li>First, log out of CasperDNS if you're currently signed in ("Log Out" in the top right).</li><br />
<li>Go to the '''[https://login.casperdns.com/changepassword.php CasperDNS Change Password]''' page. </li><br />
<li>Click the "lost password" button - you'll be taken to a screen with 3 options. </li><br />
<li>Most likely you'll be using the third option - "I know my avatar name" - so tick that button and type in your SL avatar name (NOT your display name) in the box and click ok. </li><br />
<li>The website will display a message telling you that an IM was sent to you in local chat. </li><br />
<li>Open your chat history inworld and look for this message:</li> <br />
<br />
::: "CasperTech System Message: Hello, [yourname]. You (or someone who has your avatar<br />
::: name) have requested to reset the password on your CasperTech account. IF YOU DID<br />
::: NOT REQUEST THIS ACTION - Please ignore this message. IF YOU DID REQUEST THIS<br />
::: ACTION - Please click the following URL to complete the password reset..." <br />
<br />
<li>Click the URL. You'll be taken back to the website, with a page asking you to enter your new password in twice. </li> <br />
<li>Click "OK"</li><br />
<li>The website will tell you everything is all set. You're done!</li><br />
</ol><br />
<br />
== '''<span style="color:#00528c">Changing Your CasperDNS.com password (When you remember your old one)</span>''' ==<br />
<br />
<ol><br />
<li>Go to '''[https://let.casperdns.com/ the CasperLet website]''' and login to your CasperDNS account.</li><br />
<li>Click "Change Password" link in the top right, and follow the on-screen instructions.</li><br />
</ol><br />
<br />
= '''<span style="color:#00528c">FAQ / Troubleshooting</span>''' =<br />
<br />
== Users With "AutoFill" In Their Web Browsers ==<br />
<br />
CasperVend and CasperLet are currently both branches off the casperdns.com domain. As a result, if you have "AutoFill" enabled in your web browser, BUT you have only set up ONE of the two accounts previously, you will see autofill automatically adding the password to the password field of the 2nd even though you have not set up an account yet. '''This is an expected event with AutoFill enabled.''' Simply clear out the password it puts in, and choose a different one for the 2nd account.<br />
<br />
== Redirect Loops / Not Redirecting ==<br />
You may have something installed which is blocking cookies. <br />
<br />
If you are using Chrome, press Ctrl + Shift + N to bring up an Incognito window and try again.<br />
<br />
Javascript ('''not Java!''') should be allowed to run for both casperdns.com and ajax.googleapis.com</div>24607dde-d704-4db7-afa0-d9edc17c926chttps://wiki.casperdns.com/index.php?title=Passwords_CasperLet&diff=14586Passwords CasperLet2021-05-07T17:46:05Z<p>24607dde-d704-4db7-afa0-d9edc17c926c: /* Creating Your CasperDNS.com Account */</p>
<hr />
<div>{|align=right<br />
|__TOC__<br />
|}<br />
[[File:German_flag.gif]] [[Passwords_CasperLet/DE | Schaue hier in Deutsch!]]<br />
<br />
<br />
= '''<span style="color:#00528c">Important Reminder</span>''' =<br />
{{Warning|IMPORTANT: For your own security, please do not use the same password that you use in any other vending systems, or in Second Life. Doing so runs the risk of multiple points of malicious compromise if someone manages to figure out your password.}}<br />
<br />
<br />
== '''<span style="color:#00528c">Creating Your CasperDNS.com Account</span>''' ==<br />
<br />
<br />
If you have trouble coming up with a secure password on your own, you can use the '''[https://www.grc.com/passwords.htm Gibson Research High Security Password Generator]'''. If you need a "password keeper" utility on windows, you can try '''[http://passwordsafe.sourceforge.net/ Password Safe]'''<br />
<br />
<ol><li>Go to the '''[https://let.casperdns.com/ CasperDNS Login Page]'''. You will arrive at what looks like a login prompt. Don't panic, just keep following the instructions.</li><br />
<li>Enter your username. Your CasperDNS username does not have to match your inworld avatar account name, but some folk find it easier if it does. CasperLet account names can not be changed, so make sure you use something you will be happy with.</li><br />
<li>Enter your desired password (your password should be UNIQUE and not used anywhere else, '''again do not use the same password that you use in any other vending / rental systems, or in Second Life'''.) and click ok. You'll be taken to a new screen.</li><br />
<li>Enter your email address, the same password again, and click ok.</li><br />
<li>You'll be presented with the CasperDNS front page. You are now logged in to CasperDNS at this point and can now do things in CasperLet (if you have rental units, or are a manager on someone else's CasperLet units).</li><br />
</ol><br />
<br />
== '''<span style="color:#00528c">Password Reset (when you don't remember your password)</span>''' ==<br />
<br />
<ol><br />
<li>First, log out of CasperDNS if you're currently signed in ("Log Out" in the top right).</li><br />
<li>Go to the '''[https://login.casperdns.com/changepassword.php CasperDNS Change Password]''' page. </li><br />
<li>Click the "lost password" button - you'll be taken to a screen with 3 options. </li><br />
<li>Most likely you'll be using the third option - "I know my avatar name" - so tick that button and type in your SL avatar name (NOT your display name) in the box and click ok. </li><br />
<li>The website will display a message telling you that an IM was sent to you in local chat. </li><br />
<li>Open your chat history inworld and look for this message:</li> <br />
<br />
::: "CasperTech System Message: Hello, [yourname]. You (or someone who has your avatar<br />
::: name) have requested to reset the password on your CasperTech account. IF YOU DID<br />
::: NOT REQUEST THIS ACTION - Please ignore this message. IF YOU DID REQUEST THIS<br />
::: ACTION - Please click the following URL to complete the password reset..." <br />
<br />
<li>Click the URL. You'll be taken back to the website, with a page asking you to enter your new password in twice. </li> <br />
<li>Click "OK"</li><br />
<li>The website will tell you everything is all set. You're done!</li><br />
</ol><br />
<br />
== '''<span style="color:#00528c">Changing Your CasperDNS.com password (When you remember your old one)</span>''' ==<br />
<br />
<ol><br />
<li>Go to '''[https://let.casperdns.com/ the CasperLet website]''' and login to your CasperDNS account.</li><br />
<li>Click "Change Password" link in the top right, and follow the on-screen instructions.</li><br />
</ol><br />
<br />
= '''<span style="color:#00528c">FAQ / Troubleshooting</span>''' =<br />
<br />
== Users With "AutoFill" In Their Web Browsers ==<br />
<br />
CasperVend and CasperLet are currently both branches off the casperdns.com domain. As a result, if you have "AutoFill" enabled in your web browser, BUT you have only set up ONE of the two accounts previously, you will see autofill automatically adding the password to the password field of the 2nd even though you have not set up an account yet. '''This is an expected event with AutoFill enabled.''' Simply clear out the password it puts in, and choose a different one for the 2nd account.<br />
<br />
== Redirect Loops / Not Redirecting ==<br />
You may have something installed which is blocking cookies. <br />
<br />
If you are using Chrome, press Ctrl + Shift + N to bring up an Incognito window and try again.<br />
<br />
Javascript ('''not Java!''') should be allowed to run for both casperdns.com and ajax.googleapis.com</div>24607dde-d704-4db7-afa0-d9edc17c926chttps://wiki.casperdns.com/index.php?title=Passwords_CasperLet&diff=14585Passwords CasperLet2021-05-07T17:45:22Z<p>24607dde-d704-4db7-afa0-d9edc17c926c: /* Creating Your CasperDNS.com Account */</p>
<hr />
<div>{|align=right<br />
|__TOC__<br />
|}<br />
[[File:German_flag.gif]] [[Passwords_CasperLet/DE | Schaue hier in Deutsch!]]<br />
<br />
<br />
= '''<span style="color:#00528c">Important Reminder</span>''' =<br />
{{Warning|IMPORTANT: For your own security, please do not use the same password that you use in any other vending systems, or in Second Life. Doing so runs the risk of multiple points of malicious compromise if someone manages to figure out your password.}}<br />
<br />
<br />
== '''<span style="color:#00528c">Creating Your CasperDNS.com Account</span>''' ==<br />
<br />
<br />
If you have trouble coming up with a secure password on your own, you can use the '''[https://www.grc.com/passwords.htm Gibson Research High Security Password Generator]'''. If you need a "password keeper" utility on windows, you can try '''[http://passwordsafe.sourceforge.net/ Password Safe]'''<br />
<br />
<ol><li>Go to the '''[https://let.casperdns.com/ CasperDNS Login Page]'''. You will arrive at what looks like a login prompt. Don't panic, just keep following the instructions.</li><br />
<li>Enter your username. Your CasperDNS username does not have to match your inworld avatar account name, but some folk find it easier if it does. CasperLet account names can not be changed, so make sure you use something you will be happy with.</li><br />
<li>Enter your desired password (your password should be UNIQUE and not used anywhere else, again do not use the same password that you use in any other vending / rental systems, or in Second Life.) and click ok. You'll be taken to a new screen.</li><br />
<li>Enter your email address, the same password again, and click ok.</li><br />
<li>You'll be presented with the CasperDNS front page. You are now logged in to CasperDNS at this point and can now do things in CasperLet (if you have rental units, or are a manager on someone else's CasperLet units).</li><br />
</ol><br />
<br />
== '''<span style="color:#00528c">Password Reset (when you don't remember your password)</span>''' ==<br />
<br />
<ol><br />
<li>First, log out of CasperDNS if you're currently signed in ("Log Out" in the top right).</li><br />
<li>Go to the '''[https://login.casperdns.com/changepassword.php CasperDNS Change Password]''' page. </li><br />
<li>Click the "lost password" button - you'll be taken to a screen with 3 options. </li><br />
<li>Most likely you'll be using the third option - "I know my avatar name" - so tick that button and type in your SL avatar name (NOT your display name) in the box and click ok. </li><br />
<li>The website will display a message telling you that an IM was sent to you in local chat. </li><br />
<li>Open your chat history inworld and look for this message:</li> <br />
<br />
::: "CasperTech System Message: Hello, [yourname]. You (or someone who has your avatar<br />
::: name) have requested to reset the password on your CasperTech account. IF YOU DID<br />
::: NOT REQUEST THIS ACTION - Please ignore this message. IF YOU DID REQUEST THIS<br />
::: ACTION - Please click the following URL to complete the password reset..." <br />
<br />
<li>Click the URL. You'll be taken back to the website, with a page asking you to enter your new password in twice. </li> <br />
<li>Click "OK"</li><br />
<li>The website will tell you everything is all set. You're done!</li><br />
</ol><br />
<br />
== '''<span style="color:#00528c">Changing Your CasperDNS.com password (When you remember your old one)</span>''' ==<br />
<br />
<ol><br />
<li>Go to '''[https://let.casperdns.com/ the CasperLet website]''' and login to your CasperDNS account.</li><br />
<li>Click "Change Password" link in the top right, and follow the on-screen instructions.</li><br />
</ol><br />
<br />
= '''<span style="color:#00528c">FAQ / Troubleshooting</span>''' =<br />
<br />
== Users With "AutoFill" In Their Web Browsers ==<br />
<br />
CasperVend and CasperLet are currently both branches off the casperdns.com domain. As a result, if you have "AutoFill" enabled in your web browser, BUT you have only set up ONE of the two accounts previously, you will see autofill automatically adding the password to the password field of the 2nd even though you have not set up an account yet. '''This is an expected event with AutoFill enabled.''' Simply clear out the password it puts in, and choose a different one for the 2nd account.<br />
<br />
== Redirect Loops / Not Redirecting ==<br />
You may have something installed which is blocking cookies. <br />
<br />
If you are using Chrome, press Ctrl + Shift + N to bring up an Incognito window and try again.<br />
<br />
Javascript ('''not Java!''') should be allowed to run for both casperdns.com and ajax.googleapis.com</div>24607dde-d704-4db7-afa0-d9edc17c926chttps://wiki.casperdns.com/index.php?title=Passwords_CasperLet&diff=14584Passwords CasperLet2021-05-07T17:44:02Z<p>24607dde-d704-4db7-afa0-d9edc17c926c: /* Creating Your CasperDNS.com Account */</p>
<hr />
<div>{|align=right<br />
|__TOC__<br />
|}<br />
[[File:German_flag.gif]] [[Passwords_CasperLet/DE | Schaue hier in Deutsch!]]<br />
<br />
<br />
= '''<span style="color:#00528c">Important Reminder</span>''' =<br />
{{Warning|IMPORTANT: For your own security, please do not use the same password that you use in any other vending systems, or in Second Life. Doing so runs the risk of multiple points of malicious compromise if someone manages to figure out your password.}}<br />
<br />
<br />
== '''<span style="color:#00528c">Creating Your CasperDNS.com Account</span>''' ==<br />
<br />
<br />
If you have trouble coming up with a secure password on your own, you can use the '''[https://www.grc.com/passwords.htm Gibson Research High Security Password Generator]'''. If you need a "password keeper" utility on windows, you can try '''[http://passwordsafe.sourceforge.net/ Password Safe]'''<br />
<br />
<ol><li>Go to the '''[https://let.casperdns.com/ CasperDNS Login Page]'''. You will arrive at what looks like a login prompt. Don't panic, just keep following the instructions.</li><br />
<li>Enter your username. Your CasperDNS username does not have to match your inworld avatar account name, but some folk find it easier if it does. CasperLet account names can not be changed, so make sure you use something you will be happy with.</li><br />
<li>Enter your desired password (your password should be UNIQUE and not used anywhere else) and click ok. You'll be taken to a new screen.</li><br />
<li>Enter your email address, the same password again, and click ok.</li><br />
<li>You'll be presented with the CasperDNS front page. You are now logged in to CasperDNS at this point and can now do things in CasperLet (if you have rental units, or are a manager on someone else's CasperLet units).</li><br />
</ol><br />
<br />
== '''<span style="color:#00528c">Password Reset (when you don't remember your password)</span>''' ==<br />
<br />
<ol><br />
<li>First, log out of CasperDNS if you're currently signed in ("Log Out" in the top right).</li><br />
<li>Go to the '''[https://login.casperdns.com/changepassword.php CasperDNS Change Password]''' page. </li><br />
<li>Click the "lost password" button - you'll be taken to a screen with 3 options. </li><br />
<li>Most likely you'll be using the third option - "I know my avatar name" - so tick that button and type in your SL avatar name (NOT your display name) in the box and click ok. </li><br />
<li>The website will display a message telling you that an IM was sent to you in local chat. </li><br />
<li>Open your chat history inworld and look for this message:</li> <br />
<br />
::: "CasperTech System Message: Hello, [yourname]. You (or someone who has your avatar<br />
::: name) have requested to reset the password on your CasperTech account. IF YOU DID<br />
::: NOT REQUEST THIS ACTION - Please ignore this message. IF YOU DID REQUEST THIS<br />
::: ACTION - Please click the following URL to complete the password reset..." <br />
<br />
<li>Click the URL. You'll be taken back to the website, with a page asking you to enter your new password in twice. </li> <br />
<li>Click "OK"</li><br />
<li>The website will tell you everything is all set. You're done!</li><br />
</ol><br />
<br />
== '''<span style="color:#00528c">Changing Your CasperDNS.com password (When you remember your old one)</span>''' ==<br />
<br />
<ol><br />
<li>Go to '''[https://let.casperdns.com/ the CasperLet website]''' and login to your CasperDNS account.</li><br />
<li>Click "Change Password" link in the top right, and follow the on-screen instructions.</li><br />
</ol><br />
<br />
= '''<span style="color:#00528c">FAQ / Troubleshooting</span>''' =<br />
<br />
== Users With "AutoFill" In Their Web Browsers ==<br />
<br />
CasperVend and CasperLet are currently both branches off the casperdns.com domain. As a result, if you have "AutoFill" enabled in your web browser, BUT you have only set up ONE of the two accounts previously, you will see autofill automatically adding the password to the password field of the 2nd even though you have not set up an account yet. '''This is an expected event with AutoFill enabled.''' Simply clear out the password it puts in, and choose a different one for the 2nd account.<br />
<br />
== Redirect Loops / Not Redirecting ==<br />
You may have something installed which is blocking cookies. <br />
<br />
If you are using Chrome, press Ctrl + Shift + N to bring up an Incognito window and try again.<br />
<br />
Javascript ('''not Java!''') should be allowed to run for both casperdns.com and ajax.googleapis.com</div>24607dde-d704-4db7-afa0-d9edc17c926c