meta data for this page
  •  

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
search_engine_ranker:script_manual [2021-08-12 10:35] – [The STEP Section] svensearch_engine_ranker:script_manual [2025-02-14 12:27] (current) – 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)]]
Line 93: Line 94:
 |form class|Try to find a form on the current webpage that has a class as in the variable content. Again you can use %%|%% to have multiple variations. Not many sites use a class in the <form> tag but some do.\\ \\ //Example: form class=cls-input//\\ \\ This tries to find a from with the class called cls-input.| |form class|Try to find a form on the current webpage that has a class as in the variable content. Again you can use %%|%% to have multiple variations. Not many sites use a class in the <form> tag but some do.\\ \\ //Example: form class=cls-input//\\ \\ This tries to find a from with the class called cls-input.|
 |form name|Try to find a form on the current webpage that has a name like the variable content. If no name is used in the <form> tag, the caption of the submit button is used.\\ \\ //Example: form name=*Sign Up%%|%%*Register//\\ \\ This tries to find a form there the name or the submit button's name is either matching "*Sign Up" or "*Register".| |form name|Try to find a form on the current webpage that has a name like the variable content. If no name is used in the <form> tag, the caption of the submit button is used.\\ \\ //Example: form name=*Sign Up%%|%%*Register//\\ \\ This tries to find a form there the name or the submit button's name is either matching "*Sign Up" or "*Register".|
 +|form method|Try to find a form on the current webpage that has a method as in the variable content (post or get).\\ \\ //Example: form method=post//\\ \\ This tries to find a from with the method post and not get.|
 |form url|Try to find a form where the submission URL would match the variable content.\\ \\ //Example: form url=*/signup.php%%|%%*/signup///\\ \\ This tries to find a form where the resulting submission URL after pressing the submit button would match "*/signup.php" or "*/signup/".| |form url|Try to find a form where the submission URL would match the variable content.\\ \\ //Example: form url=*/signup.php%%|%%*/signup///\\ \\ This tries to find a form where the resulting submission URL after pressing the submit button would match "*/signup.php" or "*/signup/".|
 |form url ignore|Ignores forms where the submission URL would match the variable content.\\ \\ //Example: form url ignore=*/search.php//\\ \\ This tries to ignore a form where the resulting submission URL after pressing the submit button would match "*/search.php".| |form url ignore|Ignores forms where the submission URL would match the variable content.\\ \\ //Example: form url ignore=*/search.php//\\ \\ This tries to ignore a form where the resulting submission URL after pressing the submit button would match "*/search.php".|
Line 100: Line 102:
 |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".\\|
Line 123: Line 126:
 |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%%"\\ It would now be "%%http://www.something.com/show/index.php%%"|+|verify url\\ verify url remove\\ verify url replace\\ verify url must have|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 132: Line 135:
 |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 218: Line 222:
 |tier data|Sets the data that will overwrite the input data for tier projects. Just if the "tier data" is empty it will use the one that the user set.\\ \\ //Example: tier data=%tier_title%//\\ \\ If the project is a tier project, it will not use the input data, but instead fill it from the variable %tier_data% which can e.g. be a extract-variable that downloads the URL and extracts the <title></title> value.| |tier data|Sets the data that will overwrite the input data for tier projects. Just if the "tier data" is empty it will use the one that the user set.\\ \\ //Example: tier data=%tier_title%//\\ \\ If the project is a tier project, it will not use the input data, but instead fill it from the variable %tier_data% which can e.g. be a extract-variable that downloads the URL and extracts the <title></title> value.|
 |allow data url|0 = do not allow data URLs -> gets removed\\ 1 = allow them (default)\\ \\ This will remove e.g. images from the article that are Data-URLs| |allow data url|0 = do not allow data URLs -> gets removed\\ 1 = allow them (default)\\ \\ This will remove e.g. images from the article that are Data-URLs|
 +|resize=<width>x<height>|for files to choose only and only for image types. This will dynamically resize the image if required for one engine.|
 +|filter|What to accept when type=file is used as files. Example: filter=Image files|*.jpg;*.jpeg;*.png;*.gif|PNG|*.png|GIF|*.gif|Jpeg|*.jpg;*.jpeg
  
  
Line 280: Line 286:
 |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.| |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 =====