CasperVend 2/Quick Start: Difference between revisions

From CasperTech Wiki
Jump to navigation Jump to search
mNo edit summary
Line 1: Line 1:
__NOTOC__
{|align=right
== '''<span style="color:#00528c">Getting Started</span>''' ==
  |__TOC__
  |}


You can get selling with CasperVend '''FAST'''! Just follow these steps to get started.  
== '''<span style="color:#00528c">Create Your Products</span>''' ==
: 1) Create your products for sale. If your products are items to be rezzed (like furniture or buildings), remember to set the next-owner permissions '''while they are rezzed inworld.'''


[[File:German_flag.gif]] [[CasperVend_2/Quick_Start/DE | Dies in deutsch!]]
: 2) Create the pictures to be used for your vendors and upload them to SL. <br />''(The vendors will call the image by the UUID, and there is no UUID if the image hasn't been uploaded to SL.) ''


==== 1) Rez the included DropBox ====
: 3) Create your shipping package. You cannot use folders with CasperVend - the dropbox is only capable of sending packaged products. <br /> '' (box, bag, crate, whatever you want to be seen when your customers unpack everything.)''
----
:: ''This is what sends your customers their purchases and for this reason, your dropbox '''must''' stay rezzed out somewhere it can stay long term - the DropBox (like other scripted delivery systems) cannot deliver your products if it is not rezzed inworld.''


:: ''We recommend a limit of around 200 items per DropBox just to keep things from taking forever to load as you add new products.'' 
: 4) If your items need to be rezzed anyway, simply right-click > edit > general tab > set default action to "open" on click.  


:: ''We also recommend that you have a second - duplicate set - of your dropbox(es) on at least one additional sim/region, to provide a second source for delivery. See the '''[[CasperVend_2/DropBoxes | DropBoxes]]''' page for more details.''
: 5) If you want your shipping package to unpack on rez (or on wearing) there are third party scripts available on Marketplace or Primbay. Remember to TEST FIRST.


==== 2) Package Your Product (If Necessary) In A Shipping Package (box/bag/etc.) - No Folders ====
== '''<span style="color:#00528c">Package Your Products</span>''' ==
----
: 1) Each product (with its respective parts) goes in '''one''' shipping package.  
:: ''If your product is in multiple pieces - like a set of clothing - '''OR''' you want to include notecards, pictures, and/or a landmark together with the product when it is sold (so that the customer has them all together when they unpack the package), you WILL need to put it in a box, bag or shipping crate. Due to grid limitations, CasperVend cannot deliver a folder out of the DropBox.''


:: <span style="color:#F00;">'''''IMPORTANT:''' Set your permissions properly on rezzable products WHILE THEY ARE REZZED INWORLD, and BEFORE you put them in the shipping package! ''</span>
: 2) Add any relevant notecards, landmarks, product pictures, etc. that you want the customers to have for that product into that shipping package at this time.


==== 3) Give Unique Names To Product Shipping Packages, Notecards, Landmarks & Textures  ====
: 3) Make sure each product package has its own unique name.
----
::''Delivery works by '''NAME''', not UUID - if you have different things with identical names, it may deliver ANY of them, at random, which means your customer may get a picture or a notecard instead of your packaged product!''


:: <span style="color:#F00;">'''''IMPORTANT:''' This means that if your product is in multiple pieces - like a set of clothing - that you WILL need to put it in a box, bag or shipping crate. CasperVend cannot deliver a folder out of the DropBox.''</span>
: 4) Unpack your CasperVend shipping crate.  


:: ''If you want to have everything with the same name, you need SOME sort of differentiation somewhere - for example "PIC" or "NOTE" (without the quotes) - just so that the DropBox knows that they're not a backup for your packaged product.
: 5) Rez a copy of the CasperTech DropBox (the box, not the sphere) and start putting your product packages in it.


==== 4) Shipping Package Goes in DropBox ====
: 6) Add your store landmark - and give it a generic name, such as '''"((your store name)) - Main Location"'''
----
:: ''Right click the DropBox, go to "Edit", then the "Contents" tab. Then, simply drag the packaged product(s) from your inventory into the DropBox. The box will upload your items in around 30 seconds - please '''pay attention to any messages the box issues''', it will warn you if you have put items into it that you don't have permission to transfer. If you get a warning about no transfer items, please check the contents of the prims in your build for no-transfer scripts, animations, textures, notecards, etc.''


:: <span style="color:#F00;">'''''IMPORTANT:''' Your DropBox MUST stay rezzed, or your deliveries will fail.''</span>
: 7) All packages, notecards, landmarks, and any textures must ALL have unique names. This is to prevent the system from getting confused and thinking the wrong item is the product package.


:: <span style="color:#F00;">'''''ALSO IMPORTANT:''' The DropBox CANNOT deliver a folder - you must package all the parts for each product in its own bag/box/shipping crate.''</span>
== '''<span style="color:#00528c">Set Up Product Listings</span>''' ==
: 1) Once everything is in, and the dropbox has finished sending data up to the website, click the DropBox and select "Admin" from the popup menu.  


==== 5) Add Vendor Pictures, Landmarks and Other Things ====
: 2) Let it take you to the CasperVend website where you can '''[[CasperVend_2/Password_Reset#Creating_Your_CasperVend_Account | create your account]]''' and log in.  
----
:: ''At this point, you can add all vendor textures, any separate promotional notecards for your products and your store's landmark into the DropBox as well.  


:: ''(Notecards and landmarks are NOT mandatory - just nice to be able to give out if your customer wants information they can take with them when they leave.)  
: 3) Click "Products" on the left column. (The page will appear empty, this is normal until you begin setting up products.)


:: ''The textures must be full perm '''to you''' (the system displays by UUID, and it can't get the UUID if the texture is not full perm). Ideally, these vendor textures should contain the name of item, permissions of the item, the prim count/impact of the item, and your shop logo, as well as a good picture of the item itself - but what is included is entirely at your discretion.''
: 4) Click the [[File:Listnew.png||||"List New Product"]] button


:: <span style="color:#F00;">'''''IMPORTANT:''' Textures you set to products are viewable on the delivery status page. Please don't add any textures that you don't want people to be able to download.''</span>
: 5) You will now be presented with the product setup screen for your individual product.


:: <span style="color:#F00;">'''''ALSO IMPORTANT:''' Name your landmark something simple like '''" (your store name) - main location "''' - this way if you have to move later, you only need to replace the landmark in the dropbox, without having to update the landmark on every single product.''</span>
: 6)  See the '''[[CasperVend_2/Product_Options | product options]]''' page for details on how to set up products.


==== 6) Rez a vendor and grant debit permissions ====
: 7) To save space in your dropbox, for each product's vendor texture, simply right-click on the texture '''in your inworld inventory,''' select '''"copy UUID"''', and paste that in the UUID box within the product listing page.  
----
:: ''These permissions are required in order for the vendor to handle money on your behalf - the vendor '''cannot''' operate without debit permissions. See the '''[[Debit_Permissions | Debit Permissions]]''' page for details and full explanations.''


::'''''NOTE:''' If you rez the vendor and it appears all white, just turn it around instead of assuming it's broken. They really '''do''' work right out of the box. :)''
: 8) Remember to click "save" at the bottom when you are done filling in product information.  


==== 7) When the vendor has booted up, click it and use the "Admin" option to go to website. ====
: 9) Repeat for each product you want to set up at this time.  
----
:: ''The "Admin" option gives you a link that takes you to the website, and eventually, the vendor's configuration page. If you can't find a vendor in your vendor list, you can use the admin link to get right ot that vendor's configuration page, regardless of whether it's currently showing in the list.''


:: ''If you have rezzed out one of the panel vendors, you can get the admin link by clicking the "Caspervend" logo on the vendor.  
== '''<span style="color:#00528c">Rez Your Vendors</span>''' ==
: 1) Choose a vendor style from the CasperVend folder and rez it out.  


:: ''If you have rezzed out a "touch" or "headless" vendor, click it to get the popup menu, then select "Admin".
: 2) Grant '''[[Debit_Permissions | debit permissions]]''' - the vendor will not function without them.  


:: <span style="color:#F00;">'''''NOTE:''' You can get to the configuration page of any of '''YOUR''' vendors by clicking it inworld and selecting the "Admin" option from the popup.''</span>
: 3) At this point, you will see one or more products magically appear on your inworld vendor.  


==== 8) New Merchants, Create Your Account - Otherwise Log In ====
== '''<span style="color:#00528c">Show Specific Product(s) On Specific Vendor(s)</span>''' ==
----
:: ''If this avatar is brand new to CasperVend, you will need to set up a secure password. See the '''[[CasperVend_2/Password_Reset#Creating_Your_CasperVend_Account | password instructions]]''' for details.


:: '''''<span style="color:#F00;">IMPORTANT:''' For your own security, please do not use the same password that you use in any other vending systems, or in Second Life.</span>''
If you want to have only certain products showing on a specific multi-panel vendor, you will need to set up - and use - '''[[CasperVend_2/Profiles_and_groups | profiles]]'''.


:: ''When you have set up your password, continue logging in.''
== '''<span style="color:#00528c">Vendor Configuration - Profiles</span>''' ==


==== 9) Create Your Product Listings ====
Once you have your profiles set up, it's time to attach the appropriate profile to the appropriate vendor.  
----
:: ''Click "Products" on the left column, then the [[File:Listnew.png||||"List New Product"]] button.  


:: ''You will now be presented with the product setup screen for your individual product.''
: 1) To get to the vendor's configuration page, click the main (usually the largest, or the most centered) panel on the vendor, and select "admin" from the popup menu.


:: ''See the '''[[CasperVend_2/Product_Options | product options]]''' page for details on how to set up products.''
: 2) That will take you to the specific configuration page for that vendor.  


==== 10) Start Filling In Product Information ====
: 3) Use the "Change" link on the profile line, and use the pulldown to select the profile for that vendor.  
----
:: ''You at least need to enter a name, price, set the permissions, and choose an item to deliver, and the vendor texture. Everything else is optional. If you use alpha textures, the texture might not show properly on the CasperVend website - don't be concerned with this, the items will still show properly inworld.''


:: ''Once you have the textures selected for each product, you may delete the corresponding texture from the dropbox to save space. Alternately, you may paste the UUID of the texture from inworld into the appropriate slot in the product listing, and not have to load textures into the DropBox at all. ''
: 4) Select the profile, and click "save".  


::<span style="color:#F00;">'''''IMPORTANT:''' Take extra care to indicate the permissions properly for your products - particularly if they're no copy. We allow customers to claim redeliveries of items which are marked as "copy" on the website.''</span>
: 5) Page will process, and the appropriate profile will appear on the multi-panel vendor.  


::<span style="color:#F00;">'''''ALSO IMPORTANT:''' "Search" on a multi-product vendor does NOT mean inworld search. Vendor search allows you to find a product IN the set of products in the vendor with a specific keyword. If you want products to show on inworld search, you will need to set up your own keyword prims.''</span>
== '''<span style="color:#00528c">Vendor Configuration - Single Product</span>''' ==


==== 11) Repeat steps 9 & 10 for each product you want to configure. ====
: 1) To get to the vendor's configuration page, click the main (usually the largest, or the most centered) panel on the vendor, and select "admin" from the popup menu.
----
:: ''If you are using a multi-panel vendor, you will see your products appear in the vendor as you create them on the CasperVend website.''


:: '''Congratulations, you're now set up with your new CasperVend system!'''
: 2) That will take you to the specific configuration page for that vendor.


== '''<span style="color:#00528c">Show Specific Products Only On Certain Vendors</span>''' ==
: 3) Down at the bottom of the configuration options, there's a pulldown bar right above the column of product pictures.


:* If you wish to only load certain products on a multi-panel vendor, see the '''[[CasperVend_2/Profiles_and_groups | Profiles & Groups]]''' page for instructions.
: 4) Click that, and select the single product you want on that vendor.  


:*  If you are trying to load specific products on a 1-prim static (or other single-product vendor), use the individual product selection pulldown (below most of the other options) on the vendor's configuration page.
: 5) Page will process, and the selected product will appear on the vendor inworld.


Vendors '''cannot''' automatically know what specific product(s) you want where without either (1) setting up a profile and pointing the vendor TO that profile, or (2) selecting a single product in the case of single-product static vendors.
== '''<span style="color:#00528c">How do I....?</span>''' ==
 
== '''<span style="color:#00528c">Frequently Used Options</span>''' ==
 
You can also...
:* ...set up '''[[CasperVend_2/Affiliates | affiliate vendors]]'''
:* ...set up '''[[CasperVend_2/Affiliates | affiliate vendors]]'''
:* ...set your vendors for a '''[[CasperVend_2/Customers_Page | store-wide sale]]'''
:* ...set your vendors for a '''[[CasperVend_2/Customers_Page | store-wide sale]]'''
Line 119: Line 98:
If you need help with your CasperVend system, please see '''[[CasperVend_2/Getting Help|Getting Help]]''' for information on how to get in touch with us.
If you need help with your CasperVend system, please see '''[[CasperVend_2/Getting Help|Getting Help]]''' for information on how to get in touch with us.


Thanks for using CasperVend!
== '''<span style="color:#00528c">FAQ / Troubleshooting</span>''' ==


== '''<span style="color:#00528c">FAQ / Troubleshooting</span>''' ==
: '''Q. I'm setting up my vendors, but they're not booting up and I don't see the debit perm windows!'''
: '''Q. I'm setting up my vendors, but they're not booting up and I don't see the debit perm windows!'''
:: '''A1.''' Vendors don't finish the boot process because they're waiting for you to grant debit permissions. If you are using a v3 viewer, they can accumulate behind a tiny "chicklet toast" in the corner of your screen. Check the upper right and the lower right to see if they're hanging out there waiting for you to answer.  
:: '''A1.''' Vendors don't finish the boot process because they're waiting for you to grant debit permissions. If you are using a v3 viewer, they can accumulate behind a tiny "chicklet toast" in the corner of your screen. Check the upper right and the lower right to see if they're hanging out there waiting for you to answer.  
:: '''A2.''' All viewer3-style viewers actually '''store''' your popup notifications, unless you dismiss them. Over time, undismissed notifications build up - if you have too many, you may not be able to log in, '''OR''' you may not actually '''SEE''' any new notifications '''at all'''. You can see details of the problem AND the fix over on the '''[http://wiki.phoenixviewer.com/fs_install_crash Firestorm wiki]'''.
:: '''A2.''' All viewer3-style viewers actually '''store''' your popup notifications, unless you dismiss them. Over time, undismissed notifications build up - if you have too many, you may not be able to log in, '''OR''' you may not actually '''SEE''' any new notifications '''at all'''. You can see details of the problem AND the fix over on the '''[http://wiki.phoenixviewer.com/fs_install_crash Firestorm wiki]'''.

Revision as of 12:53, 18 May 2016

Create Your Products

1) Create your products for sale. If your products are items to be rezzed (like furniture or buildings), remember to set the next-owner permissions while they are rezzed inworld.
2) Create the pictures to be used for your vendors and upload them to SL.
(The vendors will call the image by the UUID, and there is no UUID if the image hasn't been uploaded to SL.)
3) Create your shipping package. You cannot use folders with CasperVend - the dropbox is only capable of sending packaged products.
(box, bag, crate, whatever you want to be seen when your customers unpack everything.)
4) If your items need to be rezzed anyway, simply right-click > edit > general tab > set default action to "open" on click.
5) If you want your shipping package to unpack on rez (or on wearing) there are third party scripts available on Marketplace or Primbay. Remember to TEST FIRST.

Package Your Products

1) Each product (with its respective parts) goes in one shipping package.
2) Add any relevant notecards, landmarks, product pictures, etc. that you want the customers to have for that product into that shipping package at this time.
3) Make sure each product package has its own unique name.
4) Unpack your CasperVend shipping crate.
5) Rez a copy of the CasperTech DropBox (the box, not the sphere) and start putting your product packages in it.
6) Add your store landmark - and give it a generic name, such as "((your store name)) - Main Location"
7) All packages, notecards, landmarks, and any textures must ALL have unique names. This is to prevent the system from getting confused and thinking the wrong item is the product package.

Set Up Product Listings

1) Once everything is in, and the dropbox has finished sending data up to the website, click the DropBox and select "Admin" from the popup menu.
2) Let it take you to the CasperVend website where you can create your account and log in.
3) Click "Products" on the left column. (The page will appear empty, this is normal until you begin setting up products.)
4) Click the "List New Product" button
5) You will now be presented with the product setup screen for your individual product.
6) See the product options page for details on how to set up products.
7) To save space in your dropbox, for each product's vendor texture, simply right-click on the texture in your inworld inventory, select "copy UUID", and paste that in the UUID box within the product listing page.
8) Remember to click "save" at the bottom when you are done filling in product information.
9) Repeat for each product you want to set up at this time.

Rez Your Vendors

1) Choose a vendor style from the CasperVend folder and rez it out.
2) Grant debit permissions - the vendor will not function without them.
3) At this point, you will see one or more products magically appear on your inworld vendor.

Show Specific Product(s) On Specific Vendor(s)

If you want to have only certain products showing on a specific multi-panel vendor, you will need to set up - and use - profiles.

Vendor Configuration - Profiles

Once you have your profiles set up, it's time to attach the appropriate profile to the appropriate vendor.

1) To get to the vendor's configuration page, click the main (usually the largest, or the most centered) panel on the vendor, and select "admin" from the popup menu.
2) That will take you to the specific configuration page for that vendor.
3) Use the "Change" link on the profile line, and use the pulldown to select the profile for that vendor.
4) Select the profile, and click "save".
5) Page will process, and the appropriate profile will appear on the multi-panel vendor.

Vendor Configuration - Single Product

1) To get to the vendor's configuration page, click the main (usually the largest, or the most centered) panel on the vendor, and select "admin" from the popup menu.
2) That will take you to the specific configuration page for that vendor.
3) Down at the bottom of the configuration options, there's a pulldown bar right above the column of product pictures.
4) Click that, and select the single product you want on that vendor.
5) Page will process, and the selected product will appear on the vendor inworld.

How do I....?

When you are ready to take full advantage of the many additional options in CasperVend, see the complete user manual.

If you need help with your CasperVend system, please see Getting Help for information on how to get in touch with us.

FAQ / Troubleshooting

Q. I'm setting up my vendors, but they're not booting up and I don't see the debit perm windows!
A1. Vendors don't finish the boot process because they're waiting for you to grant debit permissions. If you are using a v3 viewer, they can accumulate behind a tiny "chicklet toast" in the corner of your screen. Check the upper right and the lower right to see if they're hanging out there waiting for you to answer.
A2. All viewer3-style viewers actually store your popup notifications, unless you dismiss them. Over time, undismissed notifications build up - if you have too many, you may not be able to log in, OR you may not actually SEE any new notifications at all. You can see details of the problem AND the fix over on the Firestorm wiki.