| Both sides previous revision Previous revision Next revision | Previous revision Next revisionBoth sides next revision |
| search_engine_ranker:script_manual [2019-06-20 08:04] – [The SETUP Section] sven | search_engine_ranker:script_manual [2020-11-05 09:11] – [Variables usable in SETUP and STEP Section] sven |
|---|
| * [[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]] |
| |
| ^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.\\ \\ Special keywords can be used such as //inurl:// or /httpstatus://. | | |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).\\ 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.| |
| |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.| |
| |
| ===== A Small Example ===== | ===== A Small Example ===== |