
Send Invites v1.1 Instructions

____________________________________________
OVERVIEW

This is a keyboard macro application which runs on Microsoft Windows XP or Vista (Untested on Windows 2000 but should work). It's designed to increase your productivity while using the Group Subscriber tool to send group invites. This tool saves you from adding each avatar name individually into the Group Invitation dialog. You simply open the dialog as you would normally, place a list of avatar names on the Windows clipboard and then use this tool to place those names into the dialog. It basically parses the list and emulates all the keystrokes for you. The tool is presented in the style of a wizard covering all the steps needed - first time around be sure to read all the information shown on the dialog. I also recommend reading the "AUTORUN OPTION" section below.

More information about this tool is on our website:
http://crystalgadgets.com/gadgets/send-invites/

____________________________________________
USER AGREEMENT

While this tool is designed to complement our in-world Group Subscriber tool, it in itself is provided as a free optional extra and therefore comes without technical support and also without any guarantee of fitness for purpose. We welcome feedback though - please visit the Crystal Gadgets store in Second Life and use the Suggestion Box.

This tool was made with the best intentions, but by using this software you agree that you use it entirely at your own risk, and will not hold the author accountable under any situation. You agree that it's your own responsibility to 1) virus check this tool and any included file(s) before using it, 2) verify that you obtained this tool from an authentic source, 3) backup your PC beforehand, and 4) read the tool's instructions before use.

You must not sell, redistribute, or alter the contents of the executable or included files unless you obtain express permission from the author beforehand. All text and images used in the executable and documentation is copyright (c) 2007 Anthony Hocken (SL alias).

____________________________________________
INSTALLATION

This tool does not come with an installer. It simply consists of a zip file which you unzip to a folder of your choice and you double click the sendinvites.exe file to run the tool. If you're not familar with the concept of "zip files" then it's simply a collection of files conveniently packaged into a single file. Use an application like Winzip, Winrar (commercial) or 7-zip (free) on Windows to unpack it.

Note that you should place everything in a folder where the application always has write permissions. This is so the application can create a settings file in the same folder. A log file containing all avatar names will also be placed in the same folder if you enable this option.

You can optionally add this tool to your Start menu. To do this just drag the sendinvites.exe file into your Start menu.

____________________________________________
UNINSTALL

This tool does not have an installer or uninstaller. Simply delete the folder which contains the macro tool and this will remove it 100% from your system. If you setup a Start menu shortcut then remember to delete that too.

____________________________________________
AUTORUN OPTION

You can run this tool without having to deal with the dialog every time. By setting up a special Windows shortcut (details given below) you will effectively 1) Launch this tool, 2) Paste the avatar names, 3) Start the macro and 4) Close the tool afterwards, all automatically. This is my preferred way of working.

Here's how to set it up (in Windows XP):

1) Drag "SendInvites.exe" file from Windows Explorer into your Start menu.

2) Locate the new entry in your Start menu. Right-click it and select "Properties" from the popup menu.

3) Select the "Shortcut" tab. Where it says "Target" add the following text to the end of the line: " autorun autoclose" (without quotes). For example, you would change:

	"D:\temp\SendInvites.exe"
   To:
	"D:\temp\SendInvites.exe" autorun autoclose
	
(Notice how the extra parameters are outside the quotes)

4) Select the "General" tab and give it a more descriptive name. Eg "Send Invites (Autorun)". Click OK to save the changes. All finished, but read on...

5) I highly recommend using a keyboard application launcher called Launchy. This will save you from having to browse the Start menu everytime you want to run this tool. If you're familar with QuickSilver on a Mac you'll be right at home here. In a nutshell, to launch an application you activate Launchy (press alt+space), type the first few letters of the application name, and hit the Enter key. That's it! Soon you'll be launching any application from your Start menu in under a second. It's a huge productivity boost. Launchy can be downloaded for free from: http://www.launchy.net

Now, you should be good to go. To use your new setup you do the same first three steps as before. I.e. Use your Group Subscriber to show the list of avatar names, copy those avatar names to the clipboard, and open the Group Invitation dialog. The next step is to use launchy to run this application by pressing alt+space, followed by the first few letters of "Send Invites" ("Send" should be enough), and hit Enter. Sit back and watch while this tool loads, automatically grabs the names from the clipboard, and enters them one-by-one into the Group Invitation dialog. When it's finished it'll play a sound to let you know and automatically close itself.

____________________________________________
FREQUENTLY ASKED QUESTIONS

Q) Do I have to buy Group Subscriber?

A) No, though it's recommended because that's what this tool was designed to work with. The only prerequisite is that there is a list of comma-seperated avatar names sitting on the Windows clipboard. How they get there is up to you - you don't necessarily have to use Group Subscriber to achieve this.

---

Q) Where can I get Group Subscriber and what does it do?

A) This is a tool for sale at the Crystal Gadgets store in Second Life. It's purpose is to allow visitors to easily join your group without having to hunt it down via search. Group Subscriber handles multiple groups, multiple admin, and notifies owner/admin of new group requests. It makes it much more convenient for visitors which means your group grows much quicker.

---

Q) I have a problem with this tool, will you help?

A) I do not provide technical support for this application. See the User Agreement for more details. A certain level of Windows technical knowledge is assumed. However, I do read all feedback submitted to the Suggestion Box at the store in Second Life. Feel free to leave the details, and mention your avatar name in the feedback if you want a personal response. If the issue is related more to the Group Subscriber tool then please send me an IM message in-world and I will try to help.

---

Q) Why provide this tool for free?

A) Although I'm a Windows developer, I'm not in the business of selling or supporting Windows software. It's provided free and separately from Group Subscriber so that purchasing Group Subscriber is not a co-requiste to obtaining this application, and therefore you can not expect customer support for it. This is for reasons of time and logistics.

---

Q) How many names can this tool handle in one go?

A) I have capped it at 100 names. It can technically handle thousands but that in itself would open this tool to abuse, hence the hard limit. This should be easily more than enough for legitimate use. If for some reason you have more than 100 names to add then just send them in batches of 100 names.

---

Q) What other uses does this tool have?

A) You can also use it to move customers from one group to another. Maybe you want to change the group name for some reason (eg you renamed your business) and created a new group for this. Once you've obtained the names from the old group you can use this tool to send out invites to the new group in batches of 100. Tip: If you have enabled this tool's option to log all names then you'll already have the names from the old group!

---

Q) How do I obtain updates?

A) Visit the store in Second Life and click the download option on the vendor. Also be sure to join our Update group to be kept informed of updates to this tool along with new products as they're released - Click the "Join Our Group" sign in the store.

---

Q) Is there a Mac/Linux version?

A) Afraid not. But feel free to try Parallels or VMWare emulation software. No guarantees that it'll work!

--- 

Q) Will it work with Windows 2000 and Vista?

A) The tool was designed for Windows XP but has been verified as working on Vista. It should also work fine on 2000 but this hasnt been verified yet.

---

Q) Will it work with Windows 95/98/Me?

A) Possibly! Though I don't think Second life itself is even compatible on those versions of Windows.

---

Q) When I run the tool a blank name gets added to the invite list.

A) I think this is a bug that occasionally happens with the Group Invitation dialog. It will prevent you from sending the invites. If this happens please close the dialog and start afresh with a blank dialog. Alternatively you can manually delete the blank name from the list, but you may be missing one name from the list if you do it this way.


____________________________________________
HISTORY

1.1
- Fix: Occasionally when user attempted to cancel a running macro by bring focus back to this app, it carried on regardless.

1.0
- Initial Release.