King?

Macro Guide
In the program you can use various macros to generate content automatically or modify things.
Please note that you can use the variable itself from the project used anywhere. E.g. if you defined
Your E-Mail you can use it in the project like %your e-mail%.
The usage is recursive and allows you to use macros in the content that a macro creates.

Inhaltsverzeichnis
Spin Syntax explained:.........................................................................................................................2
#file_links[<filename or url>,<number of lines>,<line output>].........................................................2
#file[<filename or url>] or #file=<filename or url>.............................................................................3
#grabbed or #grabbed[<line output>]...................................................................................................3
#gennick[XYZ,<min length>,<max length>]...................................................................................... 4
#random[<range>]................................................................................................................................4
#err[<number>].................................................................................................................................... 4
#trans #notrans.................................................................................................................................5
%random-<min>-<max>%.................................................................................................................. 5
%columnspinfile-<filename>-<column>%..........................................................................................5
%spinfolder-<folder>%........................................................................................................................6
%spinfolder2-<folder>%......................................................................................................................6
%spinfolderdelete-<folder>% ............................................................................................................. 6
%spinfile-<filename>%........................................................................................................................6
%file-<filename>%.............................................................................................................................. 6
%keyword%......................................................................................................................................... 7
%keyword<number>%.........................................................................................................................7
%source_url%.......................................................................................................................................7
%targeturl% or %blogurl% or %blog_url%.........................................................................................7
%targetsubdomain%.............................................................................................................................8
%targetdomain%.................................................................................................................................. 8
%targethost%........................................................................................................................................8
%targetpath%........................................................................................................................................8
%targetparameters%.............................................................................................................................9
%original_targeturl%............................................................................................................................9
%original_targethost%......................................................................................................................... 9
%original_targetpath%......................................................................................................................... 9
%original_targetparameters%.............................................................................................................. 9
%url_domain%.....................................................................................................................................9
%url_path%.......................................................................................................................................... 9
%url_parameters%............................................................................................................................... 9
%random_email% or %email%......................................................................................................... 10
%emailuser%......................................................................................................................................10
%emailhost%......................................................................................................................................10
%name%.............................................................................................................................................10
%website% or %url%.........................................................................................................................11
%blogtitle% or %blog_title%.............................................................................................................11
%meta_keyword%..............................................................................................................................11
%image_title%....................................................................................................................................11
%random_url%...................................................................................................................................12
%random_anchor_text%.................................................................................................................... 12
%url<number>%................................................................................................................................ 12
%anchor_text<number>%..................................................................................................................12

%verified_url%...................................................................................................................................12
%verified_anchor_text%....................................................................................................................12
%verified_domain%...........................................................................................................................13
%verified_host%................................................................................................................................ 13
%first_paragraph-<varname>%......................................................................................................... 13

Spin Syntax explained:

A spin syntax always begins with a { and ends with a }.
Multiple items are separated with a |. A random item is used when creating the content.
Example:
Output 1:
Output 2:

This {is|can be}a test.

This is a test.
This can be a test.

As you see above the resulting content can have two variations and a random one is used
here. However, you can also use fixed data when using so called spintags as in the example
below.
Example:
Output 1:
Output 2:

{#TAG1 I love {this|your} forum|#TAG2 Hello there}. {#TAG1 Best forum

ever.|#TAG2 How are you?}
I love this forum. Best forum ever.
Hello there. How are you?

In no way would it ever create content with I love this forum. How are you? or Hello
there. Best forum ever.. And as you see in the example above you can also use nested spin
syntax.
Another example is the use of URL domain binding like the following...
Example:
Output 1:
Output 2:

{#.de Hallo Fremder!|#.com Hello Stranger!}

For a German Site it will write: Hallo Fremder!
For a Site ending with .com it will write: Hello Stranger!

#file_links[<filename or url>,<number of lines>,<line output>]

This macro will read a random line from a file or URL and put them together according to
the <line output> mode. The line output can have the following values:
S
L
N
SP
LP
NP

Joins the lines with a single space.

Joins the lines with a new link
Joins the lines with nothing inbetween.
Same as S but reads the number of lines not randomly but one after the other.
Same as L but reads the number of lines not randomly but one after the other.
Same as N but reads the number of lines not randomly but one after the other.

You can also use a syntax like (<min lines>,<max lines>) for the parameter <number of

lines>. This would not always use the same number of lines but chose a random one
between the given range (e.g. #file_links[names.dat,(2,10),S]).
Example:
Output:

I like: #file_links[names.dat,2,S] and all on this forum who contribute to it.

These are my friends: Devin Ozz and all on this forum who contribute to it.

The macro reads two random names from the file names.dat and put a space between
them.

#file[<filename or url>] or #file=<filename or url>

This macro reads the content of a file or URL.
Example:
Output:

Something about myself: #file[about_yourself.dat]

Something about myself: I am a poor coder and need your money ;)

The macro reads the whole content of the file about_yourself.dat and inserts it into the
text.

#grabbed or #grabbed[<line output>]

This will try to insert content of grabbed content from the present website. The file xgrab.txt
can hold the definitions on how to get the content in the following way...
<h1>[...]</h1>
<title>[...]</title>
The content is collected (first match on the page only) and joined together the way that line
output is defined.
S
L
N

Joins the lines with a single space (default).

Joins the lines with a new link
Joins the lines with nothing in between.

Example:
Output:

I read #grabbed[N] and had to smile :)

I read Welcome to my Forum and had to smile :)

Assuming the webpage has a title like Welcome to my Forum and your xgrab.txt file has
something defined like <title>[...]</title> you get that output. Unfortunately I couldn't
find any decent xgrab.txt file to play with so you have to create your own or copy it from an
other program that also uses this.

#gennick[XYZ,<min length>,<max length>]

This macro generates a random nick name with a character length between min length and
max length. The first parameter is ignored for now. Just put anything you want for it.
Example:
Output:

Hello #gennick[XYZ,5,10]
Hello DevinSan

In the example above the macro created a nickname with a length of 8 characters and
inserted it in the text.

#random[<range>]
This inserts a range of characters in the text. A range can have the following syntax:
#random[a,b,c]
#random[0..9,A..Z]
Example:
Output:

This will either insert a, b or c into the text.

This will insert a number or an upper case character into the text.

My password is: test#random[0..9]#random[-,_]#random[a..z,A..Z]

My password is: test3-H

The example above inserted 3 characters according to the used ranges in the macro.

#err[<number>]
This macro is not inserting anything but indicates that the whole text for this content should
be modified with spell/type errors. The number can go from 1 to 10000 and indicates how
often spell/type errors should be created for a word. If you use 10000 you will have almost
every word in the text spelled wrong.
But why you might ask yourself now is this of any use? Normally you want to create
perfectly written content and not have your text with spell errors. Some people prefer this to
not create duplicate content and have it look more natural as spell errors happen to everyone
of us.
Used spelling errors are:
skip character
double character
reverse two characters
use next character on keyboard
additional character on keyboard

example becomes exaple (missing the m)

example becomes exxample (x repeated)
example becomes exmaple (a and p swapped)
example becomes exsmple (s is next on keyboard to a)
example becomes exsample (s is next on keyboard to a)

#trans #notrans
This macro tries to translate the text between #trans and #notrans to the language used on
the site where it is submitting to. Please note that the language detection on the site might
not always work and that this translation is done online. If the translation fails, it will use the
original text. The original text can be in any language as the translation tries to auto detect
the language, but I would suggest you to use English here.
Example:
Output:

#trans The minute that we are born we begin to die. #notrans

Die Minute, die wir geboren werden, beginnen wir zu sterben.

The example above is translating the sentence The minute that we are born we begin to
die. into Die Minute, die wir geboren werden, beginnen wir zu sterben. while we submit
to a German site like http://www.something-german.de/

%random-<min>-<max>%
This is generating a random number between min and max.
Example:
Output:

I was born on %random-1960-1980%.

I was born on 1968.

The example above generated a random number between 1960 and 1980 and finally inserted
1968.

%columnspinfile-<filename>-<column>%
This macro is reading a random line from the file and taking the set column (seperated by a ,
from it. If you use the macro with the same file name but a different column, than that exact
line is used and not again a new random line. This makes it possible to e.g. have a file with
address data and use the same content that belongs to one address instead of unrelated data.
Example:
I life in %columnspinfile-address_data.dat-1% - %columnspinfile-address_data.dat-3%.
Output:
I life in Australia Amaroo.
Lets have a quick look at the file address_data.dat:
...
Australia,ACT,Amaroo,2914,37 Parkes Road,(02) 6114 7945,
United States,OK,Oklahoma City,73109,4310 Meadow Drive,405-990-7523,

As you see it has one address each line and seperated by a ,.

The content is: Country,State,City,ZIP,Street,Phone.
Now the program takes a random line out of that file and uses that content to insert the

different columns into the text where %columnspinfile-address_data.dat-1% is the country

and %columnspinfile-address_data.dat-3% is the city.

%spinfolder-<folder>%
%spinfolder2-<folder>%
%spinfolderdelete-<folder>%
This macro is using a random file from the folder and using that as content.
Also note that the program is trying to match the same file name or file number when
locating a file in a different folder. E.g. if %spinfolder-c:\my_articles\% is using file
article6.txt than it tries to use summary6.txt (or anything with the number 6 in file
name) from the macro %spinfolder-c:\my_article_summaries\%.
%spinfolder2% is not keeping the previously used content in mind and %spinfolderdelete%
is deleting the file after using it to not use it again.
Example:
Output:

%spinfolder-c:\my_articles\%
This is the content of article 6 which I have put in a folder....

%spinfile-<filename>%
This is reading a random line from the file. Though the same line is used if this macro is
used more than once on a submission with the same file.
Example:
Output:

My name is %spinfile-names.dat% %spinfile-lnames.dat%.

My name is Earl Grey.

The example above is using the macro two times but on different files (so it is always using
a random line, just when you later use the %spinfile-names.dat or %spinfile-lnames.dat% on
the same site it is using the same content).

%file-<filename>%
This is the same as using the #file[<filename or url>] macro but it is not accepting an URL.
Example:
Output:

%file- c:\my_articles\article6.txt%
This is the content of article 6 which I have put in a folder....

%keyword%
This will insert a random keyword that you have defined in your project into the text. Please
don't use %keywords% (note the s) as that would insert all keywords into the text and not
just one.
Example:
Output:

My site is all about %keyword% and %keyword%

My site is all about division and joy .

The example above is taking two times a random keyword (in this case joy and division)
from your project and inserts it.

%keyword<number>%
This macro would insert not a random keyword but take the exact order from the project
setting. %keyword1% is taking the first defined keyword, %keyword2% the second and so
on.
Example:
Output:

My site is all about %keyword1% and %keyword2%

My site is all about joy and divistion.

Assuming you have joy, division, music, ... defined in your project as keywords you
would get the above output as it takes %keyword1% which is joy and %keyword2% which
is division.

%source_url%
This is replaced with the URL that the program clicked to get to the current page. It can be
seen as a referrer page used in HTML headers e.g. to indicate where the User came from.
Example:
Output:

I clicked on a link from %source_url% and came here.

I clicked on http://www.gsa-onlione.de and came here.

If the current URL is now http://www.gsa-online.de/contact.php but was previously on

http://www.gsa-onlione.de you would get the output from above.

%targeturl% or %blogurl% or %blog_url%

This is replaced with the current URL the program is on.
Example:
I clicked on a link from %source_url% and now I am on %targeturl%.
Output:
I clicked on http://www.gsa-onlione.de and now I am on http://www.gsaonline.de/contact.php.
This example uses the previous %source_url% macro as well to demonstrate what the
content of the macros might be.

%targetsubdomain%
This macro inserts the full domain of the site we submit to.
Example:
Output:

Nice to be on % targetsubdomain%.
Nice to be on forum.gsa-online.de.

%targetdomain%
This macro will insert the main domain without the suddomain as in the macro above.
Example:
Output:

Nice to be on % targetdomain%
Nice to be on gsa-online.de.

%targethost%
This macro will insert the host together with http:// or https:// into the text.
Example:
Output:

Now the whole site %targethost% is great.

Now the whole site http://www.gsa-online.de is great.

%targetpath%
This macro is just taking the path from the URL the program is on.
Example:
Output:

I am surfing on %targethost%%targetpath%.
I am surfing on http://www.gsa-online.de/contact.php

In this sample we used two macros as this macro alone is not making much sense in most
cases.

%targetparameters%
This macro is just taking the parameters of an URL (including the ?-Sign).
Also note that if there is no parameter used for the URL it is left empty.
Example:
Output:

I am surfing on %targethost%%targetpath%%targetparameters%.
I am surfing on http://www.gsa-online.de/contact.php?lang=de

In this case we used all tree macros from above.

%original_targeturl%
%original_targethost%
%original_targetpath%
%original_targetparameters%
These macros are referring to the very first URL used when the submission started. The
output is the same as the one without the original_ prefix.

%url_domain%
This is replaced with the domain of your URL that you want to submit.
Example:
Output:

I am working a lot on my site at %url_domain% lately.

I am working a lot on my site at gsa-online.de lately.

%url_path%
This is replaced with the path of the URL that you want to submit.

%url_parameters%
This is replaced with the parameter of the URL that you want to submit.

%random_email% or %email%
This is generating a random email address with a correct syntax and an existing domain. The
program tries to reuse the value used from names.dat (random names) to generate an email
that looks related to your name.
Example:
Output:

My email is %random_email%.
My email is [email protected].

%emailuser%
This macro will insert the content of an email that you see before the @ sign.
Example:
Output:

My email is %random_email% so the thing before the @ is %emailuser%.

My email is [email protected] so the thing before the @ is blah.

The example above might not make a lot sense when using in your project content but it
might be required for scripting things together.

%emailhost%
This macro will insert the content of an email that you see after the @ sign.
Example:
Output:

My email is %random_email% so the thing after the @ is %emailhost%.

My email is [email protected] so the thing before the @ is hotmail.com.

Again this example might not make much sense when using in your project content but it
might be required for scripting things together.

%name%
This generates a random name (first name only) and would be the same as when using the
macro %spinfile-names.dat%.
Example:
Output:

My name is %name%.
My name is Earl.

%website% or %url%
This will insert the URL you are trying to submit.
Example:
Output:

<a href=%url%>%anchor_text%</a>
<a href=http://www.gsa-onlione.de/>GSA</a>

Assuming that the URL is defined as http://www.gsa-online.de/ and the anchor text as GSA
you would get the above content.

%blogtitle% or %blog_title%
The title of the current URL you are about to submit to (everything between html tag
<title></title>) is used here.
Example:
Output:

Wow %blogtitle% is indeed an interesting topic.

Wow How to do things. is indeed an interesting topic.

Assuming the website you submit to has <title>How to do things.</title> in there html (the
one you see in top of your browser) you would get the above content.

%meta_keyword%
A random meta keyword from the site you are submitting to.
Example:
Output:

Nice to see someone writing about %meta_keyword%.

Nice to see someone writing about SEO.

Assuming that the website you submit to has

<meta name="Keywords" content="Google Ranking, SEO, Website Submission />
you would get the above content.

%image_title%
This is used for image comment engines only and will have the image title in it (or this
image if not found).
Example:
Output:

Very nice image. I think %image_title% is the best of all.

Very nice image. I think Sunset in Rostock is the best of all.

Assuming that the image you want to place a comment on is called Sunset in Rostock you
would get the above content.

%random_url%
This will insert a random URL from your project setting. The difference between %url% is
that it is purely random and not saved during submission. This makes it possible to insert not
only one URL in an article, but also another one from your project.
Example: My Website is %url% and %random_url% as well as %random_url%
Output: My Website is http://url1.com and http://url1911.com as well as http://url23.com
If you would have used %url% only, you would have three of the same URLs in the output.

%random_anchor_text%
This will work the same way as %random_url%. However it tries to stay connected tot he
last %random_url% used. This might not always work so handle with care.

%url<number>%
Uses the exact URL from your project (first is %url1%). If you have defined less URLs in
the project, it will use a random one.

%anchor_text<number>%
Uses the exact anchor text from the URL in your project. If no anchor_text was defined with
that URL it is handled the same as %anchor_text%.

%verified_url%
Uses a random URL from your verified URLs.

%verified_anchor_text%
Uses the anchor text of the last used verified URL that was used from %verified_url%

%verified_domain%
Uses a random domain from your verified URLs.

%verified_host%
Uses a random host from your verified URLs.

%first_paragraph-<varname>%
This will take the content of the the variable and only insert the first paragraph.