Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
search_engine_ranker:script_manual [2018-06-06 12:15] – [The STEP Section] svensearch_engine_ranker:script_manual [2023-10-15 12:15] (current) – [Script Manual] sven
Line 5: Line 5:
 Here are some helpful links on engine writing and syntax highlighting: Here are some helpful links on engine writing and syntax highlighting:
    
 +  * [[https://gsaserlists.com/serlib-documentation/|SERLib Documentation]]
   * [[http://forum.gsa-online.de/discussion/18031/some-snippets-to-accelerate-ini-writing|Some snippets to accelerate .ini writing]]   * [[http://forum.gsa-online.de/discussion/18031/some-snippets-to-accelerate-ini-writing|Some snippets to accelerate .ini writing]]
   * [[http://forum.gsa-online.de/discussion/13/gsa-script-editor-notepad-ser-edition|GSA Script Editor (Notepad++ SER Edition)]]   * [[http://forum.gsa-online.de/discussion/13/gsa-script-editor-notepad-ser-edition|GSA Script Editor (Notepad++ SER Edition)]]
   * [[http://forum.gsa-online.de/discussion/18057/passing-simple-protections|Tool to Debug Form-Submissions in Chrome Browser]]   * [[http://forum.gsa-online.de/discussion/18057/passing-simple-protections|Tool to Debug Form-Submissions in Chrome Browser]]
 +  * [[https://github.com/seospace/gsapi|Integrate 3rd party tools or custom coded scripts instead of using script-manual]]
  
   * [[http://forum.gsa-online.de/categories/new-engines-platforms|Forum to find help/suggestions]]   * [[http://forum.gsa-online.de/categories/new-engines-platforms|Forum to find help/suggestions]]
Line 15: Line 17:
   * [[http://forum.gsa-online.de/discussion/18031/some-snippets-to-accelerate-ini-writing|Some snippets to accelerate .ini writing]]   * [[http://forum.gsa-online.de/discussion/18031/some-snippets-to-accelerate-ini-writing|Some snippets to accelerate .ini writing]]
   * [[https://github.com/seospace/gsapi|gsapi - Simple HTTP server for GSA Search Engine Ranker]]   * [[https://github.com/seospace/gsapi|gsapi - Simple HTTP server for GSA Search Engine Ranker]]
 +  * [[https://forum.gsa-online.de/discussion/28159/serengines-command-list/p1|Additional Commands for SerENGINE Scrip Language]]
 ===== The Structure ===== ===== The Structure =====
  
Line 27: Line 30:
 Everything is not case sensitive so you don't have to care if you write **[SECTION]** or **[Section]**. There are basically two types of engines. Everything is not case sensitive so you don't have to care if you write **[SECTION]** or **[Section]**. There are basically two types of engines.
  
-  * The once that require an account and login.\\ You will have to define at least the following sections:\\ **[SETUP]**, **[REGISTER_STEP*]**, **[LOGIN_STEP*]**, **[STEP*]**+  * The once that require an account and login.\\ You will have to define at least the following sections:\\ **[SETUP]**, **[REGISTER_STEP*]**, **[LOGIN_STEP*]**, **[STEP*]**, (optional **[FIRSTLOGIN_STEP*]**)
   * Those who need no account and no login.\\ You just need the following sections:\\ **[SETUP]**, **[STEP*]**   * Those who need no account and no login.\\ You just need the following sections:\\ **[SETUP]**, **[STEP*]**
  
Line 44: Line 47:
 |page must have|This parameter is used to check whenever the webpage is usable for this engine or not. The content of this variable has to be present in the webpage (either pure text or html source). The variable can have multiple values separated by a %%|%% where just one has to match**.**\\ \\ //Example: //\\ //page must have1=Powered by XYZ%%|%%XYZ Powered//\\ //page must have2=!not allowed to access this page//\\ //page must have3=Webpage%%|%%Homepage//\\ \\ In the above example you see 3 variables and each of them has to match before a engine is used for that website. The ! parameter in "page must have2" means that the following should not appear on the page.| |page must have|This parameter is used to check whenever the webpage is usable for this engine or not. The content of this variable has to be present in the webpage (either pure text or html source). The variable can have multiple values separated by a %%|%% where just one has to match**.**\\ \\ //Example: //\\ //page must have1=Powered by XYZ%%|%%XYZ Powered//\\ //page must have2=!not allowed to access this page//\\ //page must have3=Webpage%%|%%Homepage//\\ \\ In the above example you see 3 variables and each of them has to match before a engine is used for that website. The ! parameter in "page must have2" means that the following should not appear on the page.|
 |url must have|This parameter is used the same way as "page must have" but for the URL string itself and not for the website content. \\ \\ //Example: url must have1=/wiki///\\ // url must have2=!wikipedia.com//\\ \\ In the above example we will not use this engine for URLs that contain //wikipedia//.com or do not have "/wiki/" in there URL.| |url must have|This parameter is used the same way as "page must have" but for the URL string itself and not for the website content. \\ \\ //Example: url must have1=/wiki///\\ // url must have2=!wikipedia.com//\\ \\ In the above example we will not use this engine for URLs that contain //wikipedia//.com or do not have "/wiki/" in there URL.|
-|fixed url|If no "//search term//" is used, you have to use this tag to indicate that the submission is just happening on one fixed site (usualy some kind of web 2.0  site with blog creation). \\ \\ //Example: fixed url=//[[https://my.opera.com/|https://my.opera.com]]\\ \\ This is than adding the URL to the target URLs of the project and starts a submission to it. |+|fixed url|If no "//search term//" is used, you have to use this tag to indicate that the submission is just happening on one fixed site (usualy some kind of web 2.0  site with blog creation). \\ \\ //Example: fixed url=//%%https://my.opera.com/%%\\ \\ This is than adding the URL to the target URLs of the project and starts a submission to it. |
 |search term|This is used to search for new targets on the internet with the help of search engines like google.\\ \\ //Example: //\\ //search term="Powered by XYZ"%%|%%"Powered by XYZ"//\\ \\ The example above uses two possible search queries. You can use also encoded the search term already if you want with "%90%AF%24". This is useful for queries in some strange language. The program will pick one of the queries randomly so the order is not important.| |search term|This is used to search for new targets on the internet with the help of search engines like google.\\ \\ //Example: //\\ //search term="Powered by XYZ"%%|%%"Powered by XYZ"//\\ \\ The example above uses two possible search queries. You can use also encoded the search term already if you want with "%90%AF%24". This is useful for queries in some strange language. The program will pick one of the queries randomly so the order is not important.|
 |add keyword to search|1 = Add a keyword from the project to the search query\\ 0 = Never add a keyword to the search query\\ 2 = Add just sometimes a keyword to it if it seems to be useful (default)| |add keyword to search|1 = Add a keyword from the project to the search query\\ 0 = Never add a keyword to the search query\\ 2 = Add just sometimes a keyword to it if it seems to be useful (default)|
Line 64: Line 67:
 |multiple posts per account|Defines if it is allowed to create more than one post per account. By default this is set to 1 (true) but only used for Article posting engines. On some engines it is useful to set this to 0 (false) when just one Article is possible to be posted (e.g. article in profile link)| |multiple posts per account|Defines if it is allowed to create more than one post per account. By default this is set to 1 (true) but only used for Article posting engines. On some engines it is useful to set this to 0 (false) when just one Article is possible to be posted (e.g. article in profile link)|
 |keep subdomain|Defines if a special domain with it's subdomains should be handled as a new site/domain.\\ \\ //Example: keep subdomain=domainXYZ.com//\\ \\ If the program has two URLs like A.domainXYZ.com and B.domainXYZ.com, then it will handle them as two different sites where it previously would have taken them as the same.| |keep subdomain|Defines if a special domain with it's subdomains should be handled as a new site/domain.\\ \\ //Example: keep subdomain=domainXYZ.com//\\ \\ If the program has two URLs like A.domainXYZ.com and B.domainXYZ.com, then it will handle them as two different sites where it previously would have taken them as the same.|
 +|max download size|Overwrites the global filter for the maximum amount of MB to download per GET/POST request.|
 ===== The STEP Section ===== ===== The STEP Section =====
  
Line 70: Line 73:
  
   * [REGISTER_STEP*] - used to create an account   * [REGISTER_STEP*] - used to create an account
 +  * [FIRSTLOGIN_STEP*] - used **only ones** to login after account registration is done and first login ever is performes
   * [LOGIN_STEP*] - used to log into the site with the created account   * [LOGIN_STEP*] - used to log into the site with the created account
   * [STEP*] - he actual submission process   * [STEP*] - he actual submission process
Line 97: Line 101:
 |seconds to wait before submission condition|This will only delay the submission if something in the variable content is found on the webpage.\\ \\ //Example: seconds to wait before submission condition=stop_spam_time//\\ \\ If the word "//stop_spam_time"// is either present in the html source or the visible text we wait with the submission a given time, else we skip this.| |seconds to wait before submission condition|This will only delay the submission if something in the variable content is found on the webpage.\\ \\ //Example: seconds to wait before submission condition=stop_spam_time//\\ \\ If the word "//stop_spam_time"// is either present in the html source or the visible text we wait with the submission a given time, else we skip this.|
 |post data|This is hardly used but will create a custom data that is used to submit to websites instead of using the data from <form>.\\ \\ //Example: post data=this=that&something=else//\\ \\ Have a look in the Pingback or Trackback engine where this is used.| |post data|This is hardly used but will create a custom data that is used to submit to websites instead of using the data from <form>.\\ \\ //Example: post data=this=that&something=else//\\ \\ Have a look in the Pingback or Trackback engine where this is used.|
 +|http header|Add additional headers to the HTTP Request Header.\\ \\ //Example: http header=X-WP-Nonce: xyz;AnotherOne: 123//\\ \\ Used in //Wordpress - Article// engine.|
 |encode post data|1 = encode the data in a proper way as used in POST protocol\\ 2 = encode it using multipart \\ 0 = take the data as it is without encoding anything\\ 3 = encode it using json syntax| |encode post data|1 = encode the data in a proper way as used in POST protocol\\ 2 = encode it using multipart \\ 0 = take the data as it is without encoding anything\\ 3 = encode it using json syntax|
 |variable must be used|A form is only submitted if certain variables have been used in that form.\\ \\ //Example: variable must be used=url,login%%|%%email//\\ \\ The above example requires a form to use the variable "url" or "login" and "email".\\| |variable must be used|A form is only submitted if certain variables have been used in that form.\\ \\ //Example: variable must be used=url,login%%|%%email//\\ \\ The above example requires a form to use the variable "url" or "login" and "email".\\|
-|add fixed data add fixed data condition\\ \\ \\ \\ //remove fixed data//\\ \\ //remove fixed data condition//|This will add a form field if the thing in "add fixed data condition" is found on the webpage. This works only if both variables are defined. Don't worry about this to much as you will probably never use this. It is only required if some sites add data to forms by javascript to prevent automated submissions. You can use "remove fixed data" to just remove that from the posting.\\ \\ //Example: //\\ //add fixed data=code=%captcha%;hidden=0//\\ //add fixed data condition=code_sign;hidden_data//\\ \\ If the webpage has anywhere the word "code_sign" in it we add a new form field called code that will be filled with a captcha. And if the word "hidden_data" is found we also add a new form field called "hidden" with the content "0".|+|add fixed data\\ add fixed data condition\\ \\ \\ \\ //remove fixed data//\\ \\ //remove fixed data condition//|This will add a form field if the thing in "add fixed data condition" is found on the webpage. This works only if both variables are defined. Don't worry about this to much as you will probably never use this. It is only required if some sites add data to forms by javascript to prevent automated submissions. You can use "remove fixed data" to just remove that from the posting.\\ \\ //Example: //\\ //add fixed data=code=%captcha%;hidden=0//\\ //add fixed data condition=code_sign;hidden_data//\\ \\ If the webpage has anywhere the word "code_sign" in it we add a new form field called code that will be filled with a captcha. And if the word "hidden_data" is found we also add a new form field called "hidden" with the content "0".|
 |set unknown variable\\ \\ set unknown variable condition|If a form field is unknown as we didn't define how to fill it in our engine, we could still fill it by something you define here. The submission aborts if this is not defined and something is unable to get filled. The "set unknown variable condition" doesn't have to be used but if it is, the string on that variable must be present to use this.\\ \\ //Example: set unknown variable=%question%//\\ \\ If a filed is found called "blahantispam193802378" we can still define how to fill this and it gets filled by the value %question% which is handled by a popup asking you how to fill it. Also often used it "set unknown variable=%leave%" which will simply leave the value as it is.| |set unknown variable\\ \\ set unknown variable condition|If a form field is unknown as we didn't define how to fill it in our engine, we could still fill it by something you define here. The submission aborts if this is not defined and something is unable to get filled. The "set unknown variable condition" doesn't have to be used but if it is, the string on that variable must be present to use this.\\ \\ //Example: set unknown variable=%question%//\\ \\ If a filed is found called "blahantispam193802378" we can still define how to fill this and it gets filled by the value %question% which is handled by a popup asking you how to fill it. Also often used it "set unknown variable=%leave%" which will simply leave the value as it is.|
 |match by option label|1 = A form with a select or radio field is filled by checking the variable content against the option labels (the one you see on the browser).\\ 0 = We will not check for a matching label\\ \\ //Example: match by option label=1//| |match by option label|1 = A form with a select or radio field is filled by checking the variable content against the option labels (the one you see on the browser).\\ 0 = We will not check for a matching label\\ \\ //Example: match by option label=1//|
Line 116: Line 121:
  
 ^Variable^Allowed values / Description^ ^Variable^Allowed values / Description^
-|submit success\\ \\ submit failed\\ \\ captcha failed\\ \\ submit failed retry|At the end of each STEP* the resulting webpage content is checked first against "submit success" and than against "submit failed". And if one is matching the submission is either set as successful or failed. The text is not case sensitive and multiple items can be added with %%|%%.\\ \\ //Example:\\ submit failed=<div id='errorbox'>%%|%%wrong code%%|%%letters wrong%%|%%user name already taken\\ submit success=submitted successfully\\ captcha failed=wrong code%%|%%letters wrong\\ submit failed retry=user name already taken//\\ \\ If the text "submitted successfully" appears on the webpage (source or visible text) then the submission is taken as successful. If the text "<div id='errorbox'>" is found then the submission is aborted. |+|submit success\\ \\ submit failed\\ \\ captcha failed\\ \\ submit failed retry|At the end of each STEP* the resulting webpage content is checked first against "submit success" and than against "submit failed". And if one is matching the submission is either set as successful or failed. The text is not case sensitive and multiple items can be added with %%|%%.\\ \\ //Example:\\ submit failed=<div id='errorbox'>%%|%%wrong code%%|%%letters wrong%%|%%user name already taken\\ submit success=submitted successfully\\ captcha failed=wrong code%%|%%letters wrong\\ submit failed retry=user name already taken//\\ \\ If the text "submitted successfully" appears on the webpage (source or visible text) then the submission is taken as successful. If the text "<div id='errorbox'>" is found then the submission is aborted.\\ \\ Special keywords can be used such as //inurl:// or //httpstatus://. |
 |submit success skip verify|If a submission is detected as successful and it is e.g. a REGISTER_STEP* then we can skip the verification process if certain stings appear on the page.\\ \\ //Example: submit success skip verify=>Logout<%%|%%>Log Out<//\\ \\ After a successful registration we would normally wait till an verification email arrives to continue with login and submission. However some platforms might allow you to login without this or log you in already. In that case it would be a waste of time to wait for a email from them so we continue to login and submit the content.| |submit success skip verify|If a submission is detected as successful and it is e.g. a REGISTER_STEP* then we can skip the verification process if certain stings appear on the page.\\ \\ //Example: submit success skip verify=>Logout<%%|%%>Log Out<//\\ \\ After a successful registration we would normally wait till an verification email arrives to continue with login and submission. However some platforms might allow you to login without this or log you in already. In that case it would be a waste of time to wait for a email from them so we continue to login and submit the content.|
 |verify on unknown status|1 = if a submission is not detected as successful or failed it will still be taken as successful (appearing in log with "unknown submission status")\\ 0 = we assume the submission failed (default)| |verify on unknown status|1 = if a submission is not detected as successful or failed it will still be taken as successful (appearing in log with "unknown submission status")\\ 0 = we assume the submission failed (default)|
 |verify submission|1 = verify the submission\\ 0 = do not verify the submission but assume that the link is submitted and will be visible there or is already (default) Even though this is the default behaviour, you should set it to "1" as used in most engines.\\ 2 = this submission step is not creating a link but is used for something else.\\ Example: verify submission=1\\ \\ After a successful submission the URL is put to the verification list and checked in intervals if the link appears there.| |verify submission|1 = verify the submission\\ 0 = do not verify the submission but assume that the link is submitted and will be visible there or is already (default) Even though this is the default behaviour, you should set it to "1" as used in most engines.\\ 2 = this submission step is not creating a link but is used for something else.\\ Example: verify submission=1\\ \\ After a successful submission the URL is put to the verification list and checked in intervals if the link appears there.|
-|verify by\\ \\ verify search for|Defines how to verify a submission. Possible value for "verify by":\\ \\ search = try to locate the search form on the page and submit a search using "//verify search for//"\\ url    = downloads the URL in "//verify url//" and checks for the present of "//verify search for//" which is by default your URL\\ txturl = same as "url" but checks also if the link is appearing just as a text (no html link code).\\ email  = logs into your email account and tries to find a link that is coming from the same webpage domain.\\ extractemail = just parses for data in emails\\ without downloading any URL. This might be important for verification URLs that are used later on in scripts.\\ \\ //Example: //\\ //verify by=email+search,url//\\ //verify search for=%website_title%,%url%//\\ \\ This will do actually two verifications (separated by ,). First it tires to log into your email account and checks for links and also checks on the webpage itself using the search form and searching for "Website title". Once found by one of the methods it will use that resulting URL to check for your URL.| +|verify by\\ \\ verify search for|Defines how to verify a submission. Possible value for "verify by":\\ \\ search = try to locate the search form on the page and submit a search using "//verify search for//"\\ url    = downloads the URL in "//verify url//" and checks for the present of "//verify search for//" which is by default your URL\\ txturl = same as "url" but checks also if the link is appearing just as a text (no html link code).\\ text = simple text that has to be present \\ email  = logs into your email account and tries to find a link that is coming from the same webpage domain.\\ extractemail = just parses for data in emails\\ without downloading any URL. This might be important for verification URLs that are used later on in scripts.\\ \\ //Example: //\\ //verify by=email+search,url//\\ //verify search for=%website_title%,%url%//\\ \\ This will do actually two verifications (separated by ,). First it tires to log into your email account and checks for links and also checks on the webpage itself using the search form and searching for "Website title". Once found by one of the methods it will use that resulting URL to check for your URL.| 
-|verify url\\ verify url remove\\ verify url replace|If you use "search", "url" or "txturl" in the variable "verify by" and you don't want to check on the last used URL then you can define a different URL here. Since version 11.71 you can also use multiple URLs seperated by %%|%%.\\ \\ //Example: //\\ //verify url=./index.php//\\ //verify url replace=/edit/;/show///\\ //verify url remove=sub///\\ \\ Imagine the last URL was: "[[http://www.something.com/sub/edit/?a=2|http://www.something.com/]][[http://www.something.com/sub/edit/?a=2|sub/edit/?a=2]]"\\ It would now be "[[http://www.something.com/show/index.php|http://www.something.com/show/index.php]]"|+|verify url\\ verify url remove\\ verify url replace|If you use "search", "url" or "txturl" in the variable "verify by" and you don't want to check on the last used URL then you can define a different URL here. Since version 11.71 you can also use multiple URLs seperated by %%|%%.\\ \\ //Example: //\\ //verify url=./index.php//\\ //verify url replace=/edit/;/show///\\ //verify url remove=sub///\\ \\ Imagine the last URL was: "%%http://www.something.com/sub/edit/?a=2%%"\\ It would now be "%%http://www.something.com/show/index.php%%"|
 |use original url to verify|1 = this will not use the last URL but the URL we started the whole engine with.\\ 0 = use the last URL at the end of the submission (default)\\ \\ //Example: use original url to verify=1//| |use original url to verify|1 = this will not use the last URL but the URL we started the whole engine with.\\ 0 = use the last URL at the end of the submission (default)\\ \\ //Example: use original url to verify=1//|
 |verify interval|Defines in what interval in minutes this verification should take place (default 180). \\ \\ //Example: verify interval=60//\\ \\ This checks each hour if the submission is verified.| |verify interval|Defines in what interval in minutes this verification should take place (default 180). \\ \\ //Example: verify interval=60//\\ \\ This checks each hour if the submission is verified.|
Line 129: Line 134:
 |try to continue without verification|0 = follow exact verification steps (default)\\ 1 = try to skip verification and continue\\ \\ //Example: try to continue without verification=1//\\ \\ When used in a REGISTER_STEP1 section, this would skip e.g. the email verification and try to login and submit your link. In case this goes wrong there is still the normal way to go on (wait verification + login + submit). If the result of a registration is unknown as well as login, then it doesnt continue for now but wait till registration is verified.| |try to continue without verification|0 = follow exact verification steps (default)\\ 1 = try to skip verification and continue\\ \\ //Example: try to continue without verification=1//\\ \\ When used in a REGISTER_STEP1 section, this would skip e.g. the email verification and try to login and submit your link. In case this goes wrong there is still the normal way to go on (wait verification + login + submit). If the result of a registration is unknown as well as login, then it doesnt continue for now but wait till registration is verified.|
 |modify url|This is used to change a found URL to something else.\\ \\ //Example: modify url=%targethost% %targetpath%//\\ \\ If the program starts the submission  with a URL like "%%http://www.something.com/guestbook.php/page=23%%" you will most likely not find a form to submit your link as this is only on page 1. So in this case the "modify url" removes all parameters from the URL and you end in "%%http://www.something.com/guestbook.php/page=23%%".| |modify url|This is used to change a found URL to something else.\\ \\ //Example: modify url=%targethost% %targetpath%//\\ \\ If the program starts the submission  with a URL like "%%http://www.something.com/guestbook.php/page=23%%" you will most likely not find a form to submit your link as this is only on page 1. So in this case the "modify url" removes all parameters from the URL and you end in "%%http://www.something.com/guestbook.php/page=23%%".|
-|modify url condition|If present it will check if the content is presnet on the webpage and only apply the "modify url" changes when present.|+|modify url condition|If present it will check if the content is present on the webpage and only apply the "modify url" changes when present.|
 |modify url remove|The same as "verify url remove" but used to modify a URL for the submission.| |modify url remove|The same as "verify url remove" but used to modify a URL for the submission.|
 |modify url replace|The same as "verify url replace" but used to modify a URL for the submission.| |modify url replace|The same as "verify url replace" but used to modify a URL for the submission.|
-|modify step\\ modify step condition|This will go to another submission step if the condition (something in last downloaded page from previous submission step) was found.\\ \\ //Example: modify step=2\\ modify step condition=*No verification required*//|+|modify submit method|Use this to change the form submission method. Valid values are GET and POST.| 
 +|modify step\\ modify step condition\\ modify step condition input|This will go to another submission step if the condition (something in last downloaded page from previous submission step) was found.\\ \\ //Example: modify step=2\\ modify step condition=*No verification required*//\\ the //modify step condition input// is optional and will use the content of the webpage as default|
 |Download retries|Number of tries to submit or download something (default is 1).| |Download retries|Number of tries to submit or download something (default is 1).|
 |Link type|Defines the type of backlink created. Can be anything you want but you might want to use the types already used in other scripts.| |Link type|Defines the type of backlink created. Can be anything you want but you might want to use the types already used in other scripts.|
Line 197: Line 203:
 |html to markdown|1 = Convert html code to markdown code\\ 0 = Do not convert it\\ <text> = Convert it if the text is appearing on the website.\\ Also note that "//allow html=1//" has to be set.| |html to markdown|1 = Convert html code to markdown code\\ 0 = Do not convert it\\ <text> = Convert it if the text is appearing on the website.\\ Also note that "//allow html=1//" has to be set.|
 |html to custom link format\\ custom link format|1 = convert html code to a custom format\\ 0 = Do not convert it.\\ <text> = Convert it if the text is appearing on the website.\\ \\ //Example://\\ //html to custom link format=1//\\ //custom link format=[%url% %anchor_text%]//\\ \\ This would be used for Wiki engines where a link is encoded in a special way.\\ Also note that "//allow html=1//" has to be set.| |html to custom link format\\ custom link format|1 = convert html code to a custom format\\ 0 = Do not convert it.\\ <text> = Convert it if the text is appearing on the website.\\ \\ //Example://\\ //html to custom link format=1//\\ //custom link format=[%url% %anchor_text%]//\\ \\ This would be used for Wiki engines where a link is encoded in a special way.\\ Also note that "//allow html=1//" has to be set.|
 +|basic html only|1 = keep just basic html tags (default if custom link format is used)\\ 0 = keep html as it is|
 |html line break\\ \\ html line break format|Converts a normal line break to some html line break (default <br>). You can specify the line break format in "html line break format" if it is some special line break as seen in some wiki engines.\\ \\ //Example://\\ //html line break=1//\\ //html line break format=<<BR>>//| |html line break\\ \\ html line break format|Converts a normal line break to some html line break (default <br>). You can specify the line break format in "html line break format" if it is some special line break as seen in some wiki engines.\\ \\ //Example://\\ //html line break=1//\\ //html line break format=<<BR>>//|
 |custom img format|If set, it will try to locate the html syntax for images and replace it with that new syntax.\\ \\ //Example://\\ //custom img format=[img=%url%]//| |custom img format|If set, it will try to locate the html syntax for images and replace it with that new syntax.\\ \\ //Example://\\ //custom img format=[img=%url%]//|
Line 241: Line 248:
  
 |%captcha% *image.php?*|tries to find the captcha that has image.php? in the URL path| |%captcha% *image.php?*|tries to find the captcha that has image.php? in the URL path|
-|%captcha% fixed:http://some-url-with-captcha.com/image.php?rnd=123|is not searching for a captcha but using that fixed URL|+|%captcha% fixed:%%http://some-url-with-captcha.com/image.php?rnd=123%%|is not searching for a captcha but using that fixed URL|
 |%captcha% overlay:*image.php?*|is searching for more than one captcha and combines them to one file| |%captcha% overlay:*image.php?*|is searching for more than one captcha and combines them to one file|
  
Line 275: Line 282:
 |input|By default "input" is the content of the last downloaded/submitted webpage or, if you specified url=... ,that content. With input you can change the source of the content to parse in.| |input|By default "input" is the content of the last downloaded/submitted webpage or, if you specified url=... ,that content. With input you can change the source of the content to parse in.|
 |reverse|When using //reverse=1// then it will reverse the result turning //123// into //321//.| |reverse|When using //reverse=1// then it will reverse the result turning //123// into //321//.|
 +|base64|using //base64=1// would encode the result to base64 content.| 
 +|all matches\\ delimiter|When using //all matches=1// together with //delimiter=,// you can join all found matches into one single string joined with the character defined in //delimiter//.| 
 ===== A Small Example ===== ===== A Small Example =====