When a gallery is submitted or scanned TGPX will check the to see if a link to your site is in place. To search for this link, you will need to configure the HTML code that TGPX should search for. The Reciprocal Links function allows you to do just that, and this document covers this topic.
Reciprocal Link Search Type
When you add a reciprocal link you have the option of specifying if it is a regular expression. Regular expressions are more complex than standard searches that simply look for the item as-is, but they add a great amount of flexibility. In TGPX the Perl Compatible Regular Expressions format is used for regular expressions. If you are not familiar with regular expressions, please see the Pattern Syntax portion of the PHP manual for additional information. If you check the Regular Expression box on the reciprocal link add/edit form, the item(s) you enter will be treated as regular expressions and used to match against the HTML code of the gallery page.
If the values you enter are not regular expressions, be sure to leave that box unchecked. This will cause a normal search to occur which will match the item you enter anywhere within the HTML code. For example, if you enter the code "http://www.yoursite.com" as a reciprocal link and someone submits a gallery with the HTML code "<a href="http://www.yoursite.com/index.html">YourSite Name</a>", this will match the "http://www.yoursite.com" reciprocal link since it appears in the HTML code. Note that the search is case-insensitive and will match not only exact HTML code, but also portions of code.
Viewing/Searching Reciprocal Links
To view or search your currently configured reciprocal links, access the Settings > Manage Recip Links function from the control panel menu. This will display a page where you will be able to see the currently configured reciprocal links and search them if you wish.
In the table that displays the reciprocal links items, you will find a couple of functions that you can run on a single reciprocal link. Each of those functions are described below.
|Click this icon to edit the reciprocal link. A window will appear where you will be able to edit all of it's settings.|
|Click this icon to delete this reciprocal link.|
Adding a Reciprocal Link
To add a new reciprocal link, access the Settings > Manage Recip Links function from the control panel menu. This will display your currently configured reciprocal links. Near the top of the page in the header bar that reads "Reciprocal Links" click on the icon. This will display a popup window where you will be able to enter the data for the new reciprocal link that you want to add. Each of the form fields are described below.
|Identifier||A short identifier string|
|Regular expression||Check this box if the reciprocal link code is a regular expression|
|Link Code||The HTML code to search for in the HTML of the submitted gallery|
Editing a Reciprocal Link
To edit a reciprocal link you will first need to locate it through the View/Search interface. When you locate the item you want to edit, click on the icon to bring up the reciprocal link editing interface. This interface is nearly identical to the reciprocal link addition interface, and has the same form fields with the same properties. You can make the changes that you want, and then press the Update Reciprocal Link button to save your changes.
Deleting a Reciprocal Link
To delete a reciprocal link you will first need to locate it through the View/Search interface. When you locate the item you want to delete, click on the icon, which will ask you to confirm the deletion.
You can also delete several reciprocal links at once by putting a check in the box next to the links you want to delete, then pressing the Delete button at the bottom of the page.