vBSEO Functions for Extensibility

Juan Muriente · #1 10-30-2005, 06:16 PM

vBSEO Functions for Extensibility
There are several vBSEO functions that can be used by external scripts.

NOTE: Always include the functions_vbseo.php file. Since it may already be included, the following statement should be used:

Code:

include_once 'includes/functions_vbseo.php';

1. Use the following function to convert text to the vBSEO format. This is useful for custom (non-vBulletin) urls.

Code:

$seo_title = vbseo_filter_text($title); // " A simple example here!" => "simple-example-here"

Also discussed here: Custom Addons Rewrite

2. To create vB URLs, the following calls are required (these should be executed *once*):

Code:

vbseo_get_options();
vbseo_prepare_seo_replace();
vbseo_get_forum_info();

3. The following function returns the vBSEO URL for the forum specified by id:

Code:

$forumurl = vbseo_forum_url($forumid, $pagenum);

4. This function returns the vBSEO URL for the thread based on the *associated array fetched from the database (db record)*:

Code:

$threadurl = vbseo_thread_url_row($threadrow, $pagenum);

where $threadrow is
array(
'threadid'=>xxx,
'title'=>xxx,
....
);

5. This function returns the vBSEO URL for the member profile based on the user id and username:

Code:

$memberurl = vbseo_member_url_row($userid, $username);

6. This function returns the vBSEO URL for the member list:

Code:

$memberlisturl = vbseo_memberlist_url($letter, $pagenum);

7. This function allows the rewritting of a dynamic URL with the corresponding SEO URL (including custom rewrite rules applied).

Code:

vbseo_any_url($url)

For instance, if the following CRR is defined:

Quote:

'index.php?page=(w+)$' => 'page-$1.html'

The following function call can be used:

Quote:

$seourl = vbseo_any_url('index.php?page=news'); // $seourl = 'page-news.html'

This function will allow to integrate side rewrites with CRRs better (including sitemap hack additions).

These are the most useful functions. If you are doing a specific hack (or modification) and need more insight don't hesitate to ask

We'll be launching an enhanced API, but that's further down the road

Update (supported in vBSEO2.4.1+)

8. This function allows to replace META tags with custom value:

Quote:

vbseo_replace_meta($metaname, $meta_content);

example:
vbseo_replace_meta('keywords', 'keywords replacement');

9. This function returns the specific vBSEO URL for the thread based thread row:

Quote:

$threadurl_spec = vbseo_thread_url_row_spec($thread_row, $spec);

$spec can be either:
'new' - new post URL
'last' - last post URL
'next' - next thread URL
'prev' - previous thread URL

acers · #2 10-30-2005, 11:21 PM

awesome list.. juan.. brilliant

will help a lot for the custom hacks i am doing for my site ..

msimonds · #3 10-31-2005, 04:06 PM

this is great Juan but can it be used if the scripts are in the root! as is with mine?

Juan Muriente · #4 10-31-2005, 04:38 PM

The functions referenced here create vB URLs only. From this point, they should work fine no matter where the scripts reside

reefland · #5 11-16-2005, 09:06 PM

Hi Juan,

Maybe yo can give me some additional help here. I have a page located a domain.com/directory/page.php and my forums are at domain.com/forum/. page.php includes vb functions with global.php and others as needed. So I can add the include for the functions_vbseo.php no problem but what would this actually look like for this page?

Code:

$seotitle = vbseo_filter_text($title); // " A simple example here!" => "simple-example-here"

Juan Muriente · #6 11-17-2005, 06:48 PM

Quote:

Originally Posted by reefland

Hi Juan,

Maybe yo can give me some additional help here. I have a page located a domain.com/directory/page.php and my forums are at domain.com/forum/. page.php includes vb functions with global.php and others as needed. So I can add the include for the functions_vbseo.php no problem but what would this actually look like for this page?

Code:

$seotitle = vbseo_filter_text($title); // " A simple example here!" => "simple-example-here"

Since your are rewritting vB URLs, you should use direct functions like:

vbseo_forum_url
vbseo_thread_url_row
vbseo_member_url_row
vbseo_memberlist_url.

The vbseo_filter_text() function is used to manually construct URLs for non-vB pages.

Also, with new vBSEO 2.2.1 it is possible to create CRR for non-vB folders.

Juan Muriente · #7 11-28-2005, 07:42 PM

Added function #7 (available in vBSEO 2.3.0 and up)

dongdong · #8 02-25-2006, 09:06 PM

Hallo, wäre jemand so freundlich und würde das übersetzen? Danke

Philipp Herbers · #9 02-27-2006, 08:05 AM

Hallo,

Quote:

Originally Posted by dongdong

Hallo, wäre jemand so freundlich und würde das übersetzen? Danke

ich kann es gerne in den nächsten Tagen übersetzen

dongdong · #10 02-27-2006, 07:24 PM

vielen dank phillipp

KW802 · #11 03-17-2006, 01:43 PM

For function #4 listed above, vbseo_thread_url_row, is there also a way of getting the 'new post' version as well? In specific, the 'Newest Post in Thread' Redirect URL Format version? (Even though last-post and new-post have in the same name in the vbseocp menu, it's the new-post format I'm after.)

Thanks,
Kevin

Oleg Ignatiuk · #12 03-17-2006, 03:24 PM

Hello Kevin,

we will include a special function for this in vBSEO2.4.1: vbseo_thread_url_row_spec($thread_row, $spec);
Updated tutorial: vBSEO Functions for Extensibility

thank you for suggestion!

KW802 · #13 03-17-2006, 03:34 PM

Quote:

Originally Posted by Oleg Ignatiuk

we will include a special function for this in vBSEO2.4.1: vbseo_thread_url_row_spec($thread_row, $spec);

Excellent, thank you.

In my replacement version of external.php for the RSS2 specs I use the "&goto=newpost" version of the thread for 'link' tag and the normal thread URL for the 'guid' tag.

DerTobi75 · #14 03-18-2006, 03:23 PM

[QUOTE=Juan Muriente]4. This function returns the vBSEO URL for the thread based on the *associated array fetched from the database (db record)*:

Code:

$threadurl = vbseo_thread_url_row($threadrow, $pagenum);

where $threadrow is
array(
'threadid'=>xxx,
'title'=>xxx,
....
);
Where can I get more information about that array?! I cannot get that function to work ;(

Tobi

Oleg Ignatiuk · #15 03-18-2006, 03:32 PM

Hello Tobi,

this is an array retrieved with mysql_fetch_array() function from "thread" db table.
Here is an example:

PHP Code:

  $getthreads = $db->query("

SELECT *

FROM " . TABLE_PREFIX . "thread

WHERE threadid=123

");

$threadrow = $db->fetch_array($getthreads);

 
$threadurl = vbseo_thread_url_row($thread_row);

LinkBacks (?) LinkBack to this Thread: http://www.vbseo.com/f2/vbseo-functions-extensibility-1662/
Posted By	For	Type	Date
vbSEO and vbGallery - PhotoPost Community	This thread	Refback	05-20-2008 09:57 AM
Compatibility With Vbseo? - BBpixel Forum	This thread	Refback	04-02-2008 01:39 PM
Digg Display & Digg Count - Page 2 - vBulletin.org Forum	This thread	Refback	01-17-2008 06:26 PM
TNX + vBulletin - Page 2 - TNX Support forums	This thread	Refback	10-21-2007 06:28 AM
Compatibility With Vbseo? - BBpixel Forum	This thread	Refback	02-02-2007 09:57 PM
SEO for Articles - MadeByMary	This thread	Refback	01-31-2007 06:26 AM
DownloadsII - Page 59 - vBulletin.org Forum	This thread	Refback	12-07-2006 11:51 AM
FPS_EXTERNAL.PHP -- New options added & RSS compliant version of external.php - vBulletin.org Forum	This thread	Refback	10-09-2006 10:04 PM

Similar Threads
Thread	Thread Starter	Forum	Replies	Last Post
vBSEO 2.4.0 Released - Includes Google AdSense Targeting Feature!	Juan Muriente	vBSEO Announcements	74	05-20-2006 09:29 PM
vBSEO 2.0 RC7 Released	Juan Muriente	vBSEO Announcements	17	09-08-2005 11:00 PM

SEO

vBSEO Functions for Extensibility

vBSEO Functions for Extensibility

LinkBack to this Thread: http://www.vbseo.com/f2/vbseo-functions-extensibility-1662/

Similar Threads