The BakaBT Website: Difference between revisions
Theworm4002 (talk | contribs) |
|||
(14 intermediate revisions by 4 users not shown) | |||
Line 1: | Line 1: | ||
=Header= | =Header= | ||
This page is intended to act as a guide to the BakaBT header visible on all pages. The numbered headings indicate sections of the header. This handy reference image will point out exactly where each of these sections is. | This page is intended to act as a guide to the BakaBT header visible on all pages. The numbered headings indicate sections of the header. This handy reference image will point out exactly where each of these sections is. <br> | ||
{|class="wikitable" | |||
[[File: | <table style="width: 100%" border="0"> | ||
<tr align="center"> | |||
<td> <div class="res-img">[[File:Header_2020v2.png|alt=Header_2020|Reference image with pointed out sections.]] </div></td> | |||
</tr> | |||
<tr align="center"> | |||
<td> | |||
{|class="wikitable" border="1px" | |||
=== | ! style=" font-size: 24px;" colspan="3"| BakaBT Header | ||
|- | |||
||'''1 - RSS'''||An RSS feed of recently-granted torrents. The results are filtered by the default browse options specified in your profile. (Only Power Users)|| | |||
|- | |- | ||
||''' | |colspan="3"|'''2 - Quick links''' | ||
|- | |- | ||
||''' | ||'''News'''||The front page, filled with recent news about the site.|| | ||
|- | |- | ||
||''' | ||'''Browse'''||Browse all torrents on the site.|| | ||
|- | |- | ||
||''' | |rowspan="5"| ||'''Offers'''||Recently offered torrents that have either not yet been accepted, or have been rejected. The number listed in parenthesis is the number of pending offers. Power Users can mouseover provides links to Upload (the page on which you create a new torrent offer), Sandbox (where you can play around with torrent descriptions) and Templates (a list of description templates for offers). | ||
|- | |- | ||
||''' | || '''Upload'''||Make a upload offer. | ||
|- | |- | ||
||''' | || '''Sandbox'''|| For users to try out and preview descriptions before making an offer or work on your old torrent descriptions. | ||
|- | |- | ||
||''' | || '''Templates'''||A list of templates to pick from to style your upload offer. | ||
|- | |- | ||
||''' | ||'''Adopt'''||A list of torrents in dire need of adoption. | ||
|- | |- | ||
||''' | ||'''Forums'''||Go to the forums, where you can ask questions about torrents and the site, or just chat with other BakaBT users.|| | ||
|- | |- | ||
||''' | ||'''BakaSHOTS'''|| BakaBT's image hosting server.|| | ||
|- | |- | ||
||''' | ||||'''BakaCOMPARE'''||For release comparisons . | ||
|- | |- | ||
||'''Wiki'''||What you're on.|| | |||
|- | |||
||'''IRC'''||Information on how to get connected to BakaBT's IRC channel.|| | |||
|- | |||
||'''Store'''||Get your BBT parifinalya here.|| | |||
|- | |||
||'''Donate'''||Make one-time, or set up monthly, donations and get upload credit.|| | |||
|- | |- | ||
||''' | ||'''More'''|| See below.|| | ||
|- | |||
|rowspan="6"| | |||
||'''Blog'''||The new BakaBT blog, filled with the rambings of Chiyachan and whoever else he coerces into it. | |||
|- | |||
||'''Help Form'''||A form that transmits your problems to BakaBT staff. | |||
|- | |||
||'''Top 10'''||Some nice statistics. | |||
|- | |||
||'''Banners'''||A display of all of the banners that rotate on reload. | |||
|- | |||
||'''Random'''||Takes you to a random torrent. | |||
|- | |||
||'''Keywords'''||Keywords to help you better search BBT's media. | |||
|- | |||
|colspan="3"| | |||
|- | |- | ||
||''' | ||'''3 - Search field'''||Search currently accepted torrents. Searches according to your default browse options.|| | ||
|- | |- | ||
||''' | ||'''4 - Quick Stats'''||"Welcome back, *Username* " Followed by doner icon (if you have donated) & unread message count || | ||
|- | |- | ||
||''' | |rowspan="4"| | ||
||'''Messages'''||Tracker messages (separate from forum messages). This is where you receive PMs from other users, or notifications from the system about torrent swaps, comments on notified torrents, and torrent approvals and deletions. | |||
|- | |- | ||
||'''Settings'''||Where you can change account settings. | ||'''Settings'''||Where you can change account settings. | ||
|- | |- | ||
||''' | ||'''Logout'''||Your username and a logout link. | ||
|- | |||
||'''Tracker States'''||Your tracker States, overall ratio, the amount you have uploaded, amount you have downloaded, your active torrents green for uploading and read for downloading, and your bonus points. | |||
|- | |||
|} | |} | ||
</td> | |||
</tr> | |||
</table> | |||
=Userpage= | |||
This page is intended to act as a guide to the BakaBT profile page. The numbered headings indicate sections of the page. This handy reference image will point out exactly where each of these sections is. | |||
= | <div class="res-img">[[File:Userpage_2020.png|right|alt=Userpage as seen by other users|Reference image with pointed out sections.]]</div> | ||
=== | ===1 - Avatar=== | ||
User's [[Site_Rules#Tracker_Avatar_Guidelines|tracker avatar]]. This is the image that appears in torrent offers and comments, separate from the [[Site_Rules#Forum_Ava.2FSig_Guidelines|forum avatar]]. | |||
===2 - User info & Friend Controls=== | |||
The username and [[FAQ#User_Classes|user class]] of this user. Also, the doner icon if you have donated. Followed by a flag representing the user's country of residence. NOTE: this is not Dango flag | |||
=== | ====Friend Controls==== | ||
Add this user to your Friend List, or block them. | Add this user to your Friend List, or block them. | ||
Line 106: | Line 115: | ||
===3 - Public user information=== | |||
===3 | |||
{|border="1px" | {|border="1px" | ||
Line 134: | Line 131: | ||
|- | |- | ||
||'''Donated'''||Amount of the upload credit earned by donating to BakaBT. | ||'''Donated'''||Amount of the upload credit earned by donating to BakaBT. | ||
|- | |- | ||
||'''Bonus Points'''||Number of unredeemed [[FAQ#What_are_bonus_torrents.3F|bonus points]]. "Use" takes you to a page where you can spend your bonus points. | ||'''Bonus Points'''||Number of unredeemed [[FAQ#What_are_bonus_torrents.3F|bonus points]]. "Use" takes you to a page where you can spend your bonus points. | ||
Line 144: | Line 139: | ||
|} | |} | ||
===4 - favorite Anime/Manga=== | |||
The user's favorite Anime/Manga on BBT. | |||
===5 - Info=== | |||
Any info the user has chosen to display. | |||
===6 - Categories=== | |||
Torrents that match the filtering applied by the options in [[The BakaBT Website#5_-_Tabs|5]]. You can sort by clicking on the respective category. | |||
{|border="1px" | {|border="1px" | ||
|- | |- | ||
||''' | ||'''Category'''||The category that the torrent falls into. One of Anime Series, OVA, Soundtrack, Manga, Anime Movie, Live Action, Artbook, Music Video or Light Novel. | ||
For category-icon See [http://wiki.bakabt.me/index.php?title=The_BakaBT_Website#Category-Icons 7a-7c] | |||
|- | |||
||'''Name'''||Name of the torrent. Underneath are the [[How_to_make_an_offer#Keywords|keywords (tags)]] associated with it. If you uploaded this torrent there will be two icons beside the name. The first one is for editing the description, the second one for editing the torrent info. | |||
|- | |||
||'''S/L'''||Number of seeders / leechers connected to the tracker for this torrent. | |||
|- | |- | ||
||''' | ||'''Size'''||Size of the torrent data. | ||
|- | |- | ||
||''' | ||'''Up'''||The user's recorded upload for this torrent. This number '''is''' reset when a torrent is swapped. | ||
|- | |||
||'''Down'''||The user's recorded download for this torrent. This number '''is''' reset when a torrent is swapped. | |||
|- | |||
||'''Ratio'''||The individual ratio of this torrent. The large, colorized number is up / down; the smaller, gray number is upload divided by torrent size. Inf indicates that the user has not downloaded any data of this torrent. | |||
|} | |||
===7 - Tabs=== | |||
{|border="1px" | |||
|- | |- | ||
||''' | ||'''Active'''||Torrents the user is currently downloading or has finished and now uploading to other peers. | ||
|- | |- | ||
||''' | ||'''Inactive'''||Torrents the user has uploaded, downloading or started to download and it is no longer see as active by the tracker. (no longer downloaded or uploading) | ||
|- | |- | ||
||'''Uploaded'''||Torrents the user has uploaded through [[How_to_make_an_offer|the offer system]]; rejected offers appear here until pruned. | ||'''Uploaded'''||Torrents the user has uploaded through [[How_to_make_an_offer|the offer system]]; rejected offers appear here until pruned. | ||
Line 164: | Line 190: | ||
||'''Bookmarked'''||Torrents the user has bookmarked. Bookmarked torrents are aggregated for the Related Torrents section. | ||'''Bookmarked'''||Torrents the user has bookmarked. Bookmarked torrents are aggregated for the Related Torrents section. | ||
|- | |- | ||
||'''Wishlist'''||Torrents the user has | ||'''Wishlist'''||Torrents the user has added to their wishlist. Unlike Bookmarks, Wishlist data is not used anywhere else. | ||
|- | |- | ||
||'''Notify'''||Torrents the user has enabled notification for. A message will be sent to you when someone comments on a torrent you have enabled notification for | ||'''Notify'''||Torrents the user has enabled notification for. A message will be sent to you when someone comments on a torrent you have enabled notification for | ||
Line 173: | Line 199: | ||
=== | ===Category-Icons=== | ||
Note: The icons over the torrents in the picture do not match the actual torrents. | |||
{|border="1px" | {|border="1px" | ||
|- | |- | ||
||''' | |colspan="2"|'''7.a''' | ||
|- | |||
||'''Wishlist'''||Torrents that you have added to their wishlist. Unlike Bookmarks, Wishlist data is not used anywhere else. | |||
|- | |||
||'''Bookmarked'''||Torrents that you have bookmarked. Bookmarked torrents are aggregated for the Related Torrents section. | |||
|- | |||
||'''Notify'''||Torrents you have enabled notification for. A message will be sent to you when someone comments on a torrent you have enabled notification for | |||
|- | |||
||'''Uploaded'''||Torrents you uploaded through [[How_to_make_an_offer|the offer system]]; rejected offers appear here until pruned. | |||
|- | |- | ||
||''' | |colspan="2"|'''7.b''' | ||
|- | |||
||'''Freeleech'''||A torrent that after downloading was not counted towards total download, due to [[FAQ#Freeleech|freeleeching]]. | |||
|- | |||
||'''Lossless'''||Torrents that have lossless versions of the soundtrack. | |||
|- | |||
||'''HD'''||Torrents that have at least 720p. | |||
|- | |||
||'''Hentai'''||Torrents fall under the hentai category. | |||
|- | |||
||'''Incomplete'''||Torrents seares that are not yet complete. | |||
|- | |||
||'''Bones'''||Torrents that earned you [[FAQ#What_are_bonus_torrents.3F|bonus points]]. | |||
|- | |- | ||
||''' | ||'''Multiaudio'''||Torrents that have multiple audio tracks. | ||
|- | |- | ||
||''' | |colspan="2"|'''7.c''' | ||
|- | |- | ||
|| | |colspan="2"|These icons only appear for torrents you have uploaded. | ||
|- | |- | ||
||''' | ||'''Edit Info'''||Takes you to edit this torrents info. | ||
|- | |- | ||
||''' | ||'''Edit Description'''||Takes you to the sandbox editor for this torrents description. | ||
|} | |} | ||
=Torrent Details= | |||
This page is intended to act as a guide to the layout used on the torrent pages. The numbered headings indicate sections of the page. This handy reference image will point out exactly where each of these sections is. | |||
<div class="res-img">[[File:Torrent-details_2020.png|right|alt=Userpage as seen by other users|Reference image with pointed out sections.]]</div> | |||
===1 - Torrent Icon=== | |||
Torrent type. One of Anime Series, OVA, Soundtrack, Manga, Anime Movie, Live Action, Artbook, Music Video or Light Novel. | |||
=== | ===2 - Torrent Title=== | ||
Title of the torrent. | |||
=== | ===3 -Torrent Category Icons=== | ||
See [http://wiki.bakabt.me/index.php/The_BakaBT_Website#Category-Icons Category-Icons]. | |||
=== | ===4 - Keywords=== | ||
The [[How_to_make_an_offer#Keywords|keywords (tags)]] associated with this torrent. | The [[How_to_make_an_offer#Keywords|keywords (tags)]] associated with this torrent. | ||
Line 231: | Line 271: | ||
=== | ===5 - Swap notice=== | ||
Date the torrent was last swapped. | Date the torrent was last swapped. | ||
Line 237: | Line 277: | ||
=== | ===6 - Download=== | ||
Click to download the .torrent file. Also listed is the size of the torrent. | Click to download the .torrent file. Also listed is the size of the torrent. | ||
Line 243: | Line 283: | ||
=== | ===7 - Other versions box=== | ||
Category box with the different [[Format_Preferences#Video Groupings|video format alternatives]]. | |||
===8 - User interface=== | |||
{|border="1px" | {|border="1px" | ||
|- | |- | ||
||''' | ||'''Report'''||[[FAQ#Report_problems_that_I_noticed.3F|Report this torrent]] for not following the rules.<br />Power users only. | ||
|- | |||
||'''Notify'''||Sends you notifications when new comments are posted. | |||
|- | |- | ||
||'''Wishlist'''||A list of torrents to download... sometime. You're notified when a torrent on your wishlist is swapped. | ||'''Wishlist'''||A list of torrents to download... sometime. You're notified when a torrent on your wishlist is swapped. | ||
|- | |- | ||
||''' | ||'''Blacklist'''||Torrent's you choose to add to your blacklist appear as greyed out on browse/search results page. | ||
|- | |- | ||
||''' | ||'''Bookmark'''||Keep this torrent listed in your bookmarks. Also used to calculate related torrents. | ||
|} | |} | ||
===9 - Torrent info tabs=== | |||
Tabs that provide interesting information about this torrent. Clicking leads to boxes 10-13. | |||
===10 - Statistics=== | |||
=== | |||
{|border="1px" | {|border="1px" | ||
Line 289: | Line 334: | ||
|- | |- | ||
||'''Last Seed'''||How much time has passed since a new seed has entered the swarm. | ||'''Last Seed'''||How much time has passed since a new seed has entered the swarm. | ||
|- | |||
|colspan"2"|'''11''' | |||
|- | |||
|colspan"2"|Only see if you are the torrent uploader | |||
|- | |||
||'''Edit Info'''||Takes you to edit this torrents info. | |||
|- | |||
||'''Edit Description'''||Takes you to the sandbox editor for this torrents description. | |||
|} | |} | ||
=== | |||
===12 - Filelist=== | |||
A list of the files included in the torrent and their sizes. If contained in folders, you can expand all.<br /> | A list of the files included in the torrent and their sizes. If contained in folders, you can expand all.<br /> | ||
Line 298: | Line 353: | ||
=== | ===13 - Peerlist=== | ||
Detailed information about the swarm.<br />Power users only. | Detailed information about the swarm.<br />Power users only. | ||
Line 314: | Line 369: | ||
||'''Complete'''||How much of the torrent the user has downloaded. | ||'''Complete'''||How much of the torrent the user has downloaded. | ||
|- | |- | ||
||'''Time'''||Total active time. Hts* | ||'''Time'''||Total active time. Hts*30/60. | ||
|- | |- | ||
||'''Idle'''||Time since last announce. | ||'''Idle'''||Time since last announce. | ||
|- | |- | ||
||'''Hts'''||Number of announces. | ||'''Hts'''||Number of announces. Time*60/30. | ||
|- | |- | ||
||'''Client'''||The Bittorrent client being used. | ||'''Client'''||The Bittorrent client being used. | ||
|} | |} | ||
=Forum RSS Feed= | =Forum RSS Feed= |
Latest revision as of 21:19, 10 April 2020
Header
This page is intended to act as a guide to the BakaBT header visible on all pages. The numbered headings indicate sections of the header. This handy reference image will point out exactly where each of these sections is.
|
Userpage
This page is intended to act as a guide to the BakaBT profile page. The numbered headings indicate sections of the page. This handy reference image will point out exactly where each of these sections is.
1 - Avatar
User's tracker avatar. This is the image that appears in torrent offers and comments, separate from the forum avatar.
2 - User info & Friend Controls
The username and user class of this user. Also, the doner icon if you have donated. Followed by a flag representing the user's country of residence. NOTE: this is not Dango flag
Friend Controls
Add this user to your Friend List, or block them. Your Friend List and the Users you have blocked can be found under My friends. After blocking a user the Send Message button on your user page is faded out for him and he can no longer send you any PMs.
3 - Public user information
Join Date | Date user registered with BakaBT. |
Last Seen | The last time they visited a page on BakaBT while logged in. |
Uploaded | Amount uploaded through BakaBT, and average rate of upload. |
Downloaded | Amount downloaded through BakaBT, and average rate of download. |
Bonus | Amount of the upload credit earned by redeeming bonus points. |
Donated | Amount of the upload credit earned by donating to BakaBT. |
Bonus Points | Number of unredeemed bonus points. "Use" takes you to a page where you can spend your bonus points. |
Share Ratio | Uploaded / Downloaded. There are different smilies for different ranges. |
Torrent Comments | How many times the user has posted a comment on a torrent. The number is a link to a page displaying all of the user's comments. |
4 - favorite Anime/Manga
The user's favorite Anime/Manga on BBT.
5 - Info
Any info the user has chosen to display.
6 - Categories
Torrents that match the filtering applied by the options in 5. You can sort by clicking on the respective category.
Category | The category that the torrent falls into. One of Anime Series, OVA, Soundtrack, Manga, Anime Movie, Live Action, Artbook, Music Video or Light Novel.
For category-icon See 7a-7c |
Name | Name of the torrent. Underneath are the keywords (tags) associated with it. If you uploaded this torrent there will be two icons beside the name. The first one is for editing the description, the second one for editing the torrent info. |
S/L | Number of seeders / leechers connected to the tracker for this torrent. |
Size | Size of the torrent data. |
Up | The user's recorded upload for this torrent. This number is reset when a torrent is swapped. |
Down | The user's recorded download for this torrent. This number is reset when a torrent is swapped. |
Ratio | The individual ratio of this torrent. The large, colorized number is up / down; the smaller, gray number is upload divided by torrent size. Inf indicates that the user has not downloaded any data of this torrent. |
7 - Tabs
Active | Torrents the user is currently downloading or has finished and now uploading to other peers. |
Inactive | Torrents the user has uploaded, downloading or started to download and it is no longer see as active by the tracker. (no longer downloaded or uploading) |
Uploaded | Torrents the user has uploaded through the offer system; rejected offers appear here until pruned. |
Bookmarked | Torrents the user has bookmarked. Bookmarked torrents are aggregated for the Related Torrents section. |
Wishlist | Torrents the user has added to their wishlist. Unlike Bookmarks, Wishlist data is not used anywhere else. |
Notify | Torrents the user has enabled notification for. A message will be sent to you when someone comments on a torrent you have enabled notification for |
Comment | Torrents the user has commented on. A torrent will only appear in this list once, even if the user has commented multiple times on it. |
Category-Icons
Note: The icons over the torrents in the picture do not match the actual torrents.
7.a | |
Wishlist | Torrents that you have added to their wishlist. Unlike Bookmarks, Wishlist data is not used anywhere else. |
Bookmarked | Torrents that you have bookmarked. Bookmarked torrents are aggregated for the Related Torrents section. |
Notify | Torrents you have enabled notification for. A message will be sent to you when someone comments on a torrent you have enabled notification for |
Uploaded | Torrents you uploaded through the offer system; rejected offers appear here until pruned. |
7.b | |
Freeleech | A torrent that after downloading was not counted towards total download, due to freeleeching. |
Lossless | Torrents that have lossless versions of the soundtrack. |
HD | Torrents that have at least 720p. |
Hentai | Torrents fall under the hentai category. |
Incomplete | Torrents seares that are not yet complete. |
Bones | Torrents that earned you bonus points. |
Multiaudio | Torrents that have multiple audio tracks. |
7.c | |
These icons only appear for torrents you have uploaded. | |
Edit Info | Takes you to edit this torrents info. |
Edit Description | Takes you to the sandbox editor for this torrents description. |
Torrent Details
This page is intended to act as a guide to the layout used on the torrent pages. The numbered headings indicate sections of the page. This handy reference image will point out exactly where each of these sections is.
1 - Torrent Icon
Torrent type. One of Anime Series, OVA, Soundtrack, Manga, Anime Movie, Live Action, Artbook, Music Video or Light Novel.
2 - Torrent Title
Title of the torrent.
3 -Torrent Category Icons
See Category-Icons.
4 - Keywords
The keywords (tags) associated with this torrent.
5 - Swap notice
Date the torrent was last swapped.
6 - Download
Click to download the .torrent file. Also listed is the size of the torrent.
7 - Other versions box
Category box with the different video format alternatives.
8 - User interface
Report | Report this torrent for not following the rules. Power users only. |
Notify | Sends you notifications when new comments are posted. |
Wishlist | A list of torrents to download... sometime. You're notified when a torrent on your wishlist is swapped. |
Blacklist | Torrent's you choose to add to your blacklist appear as greyed out on browse/search results page. |
Bookmark | Keep this torrent listed in your bookmarks. Also used to calculate related torrents. |
9 - Torrent info tabs
Tabs that provide interesting information about this torrent. Clicking leads to boxes 10-13.
10 - Statistics
Type | Type of torrent, one of OVA, Series, OST, Movie, Manga, Artbook or Music Video. |
Size | Amount of hard disk space the torrent will take up when fully downloaded. |
Completed | How many people have finished downloading the torrent. |
Last activity | [Last time downloaded? Last time scraped?] |
Peers | The swarm overview. |
Freeleech | Whether the torrent benefits from freeleech or not. |
Added | When this torrent was added to the pool. |
Snatches | Number of times the .torrent file was downloaded. |
Last Seed | How much time has passed since a new seed has entered the swarm. |
11 | |
Only see if you are the torrent uploader | |
Edit Info | Takes you to edit this torrents info. |
Edit Description | Takes you to the sandbox editor for this torrents description. |
12 - Filelist
A list of the files included in the torrent and their sizes. If contained in folders, you can expand all.
Can be viewed as plain text.
13 - Peerlist
Detailed information about the swarm.
Power users only.
User/IP | A link to the user's profile, or an IP address for users connected via the public key. |
Upl. | Total amount uploaded of this torrent. This is the field that the list is sorted by. |
Downl. | Total amount downloaded. |
Ratio | Uploaded / Downloaded for this torrent. |
Complete | How much of the torrent the user has downloaded. |
Time | Total active time. Hts*30/60. |
Idle | Time since last announce. |
Hts | Number of announces. Time*60/30. |
Client | The Bittorrent client being used. |
Forum RSS Feed
This tutorial will cover how to obtain specific RSS Feeds from Topics and Boards throughout BakaBT Forums.
The BakaBT forums is designed by "Simple Machine Forums", although a pain to initially set up, it is one of the most flexible and capable free forum software's available. That being said; a lot of thought went into how to make it user friendly to the members, but also so that Administration can not only easily moderate, but also obtain a constant flow of information as needed for themselves as well as members, and in certain instances; Of Members. To this end Simple Machines Forum developers created one of the most comprehensive Feed Systems available for forums to date.
Preparation
First let us start with a look at our default feed URL: http://forums.bakabt.me/index.php?type=rss;action=.xml
Simple Machine Forum utilizes this URL similar to a code build. It is the basis for the feed building blocks and is where all the feeds from here on out will begin. Simple Machine Forum allows you to build on the initial URL so that it can target Categories, Boards, and Topics, among other things, but for this Tutorial we will concentrate on Boards and Topics, as this is the most relevant to us, and all BakaBT members.
Simple Machine Forum designers kept all available technology in the loop. Although the feed is initially an RSS .91, it can be changed to accommodate any type of feed from Atom to RSS 2.0 The following is the available manipulations to the RSS Feed available to everyone:
* ;type=atom - Atom * ;type=rdf - RDF * ;type=rss - RSS 0.91 * ;type=rss2 - RSS 2.0
Do not worry if this makes no sense at this time as it will all come together...
Now that we know what type of feeds are available to all of us how can we target Boards and Topics???
Again: Simple Machine Forum Developers were thinking, and gave us a list of options to add to the initial URL.
The following is example expansions to the initial URL that can be added.
* limit=x - display the "x" number of posts (if number is less than 5, it will display 5. If number is larger than 255,
it will display 255). * board=y - display only posts from board "y" * boards=x,y,z - display only posts from the specified boards * topic=y - display only posts from board in which topic "y" is located
There is just a little more information to disseminate before we get to the heart of this tutorial.
The folks at Simple Machines Forum also gave us "Sub-action(s)". Now without listing all of the available Sub-Actions, I will just show the two that immediately affect all BakaBT members:
* Recent Posts (displays the most recent posts that you can see) sa=recent * News (displays the first post from the most recent topics that you can see) sa=news
Creating the custom feed
Now that we have all the parts that are required, let's put it all together.
The following are examples of targeted Feeds from the BakaBT forums:
BakaBT - New Torrent Requests (Board Example)
http://forums.bakabt.me/index.php?action=.xml;sa=recent;board=3.0;limit=20;type=rss2
BakaBT - Site Feedback & Rules (Topic Example)
http://forums.bakabt.me/index.php?action=.xml;sa=news;topic=22306;limit=20;type=rss
In the above examples you will find that I have color coded the the various parts that will be required in order to obtain the Targeted Feed that we want.
As you can see in the light blue is the initial Forum URL.
- NOTE:
- Now as we build the URL coding up, you must add a "semi-colon" ( ; ) after each addition to the URL.
In the above examples:
The Green is the defined "Sub-Action". Most commonly we will utilize "sa=recent" in our URL(s), as this will give a rolling feed, and not just the first post to a topic.
The Navy Blue area defines the the topic or board that we wish to obtain a feed from.
The Purple area defines how many posts will be fed to us via the Feed. I tend to leave this at 20, as this will limit bandwidth load to the forum server, and allow our Feed to load faster as well...You can not do less than a five (5) posts, and you can not request more than 255 at any given time. If you want more than 20 feeds, be respectful of the forum and the server, as this will start introducing a large drain on the bandwidth from the forum server.
The Red represents the the Feed type. In my case, I tend to leave mine as RSS2 as this qualifies for the most information with least trouble from the four available types.
Examples
Now that I have assembled the pieces, how do I define what Board(s) or Topic(s) I want a feed from?
Lets take the example of the first example feed above:
BakaBT - New Torrent Requests (Board Example) http://forums.bakabt.me/index.php?action=.xml;sa=recent;board=3.0;limit=20;type=rss2
This one is labeled "BakaBT - New Torrent Requests".
If you look at your browser's Address bar you will see something like this:
Off all the things in the Address bar we only want a certain part, we want to know if this is a topic or a board and what the number sequence is;
In this case we are interested in "topic=22306.0"
Now that I have the information required, I am going to take my Example code and copy/paste the "topic=22306.0" into it:
So I will go from this: http://forums.bakabt.me/index.php?action=.xml;sa=recent;board=3.0;limit=20;type=rss2
To this: http://forums.bakabt.me/index.php?action=.xml;sa=recent;topic=22306.0;limit=20;type=rss2
Now here is a kick in the shorts:
Listing "Topics" will rarely work, if you list a "Topic" in your URL, it will most likely refer to the Board it is posted tom and not the topic directly. If a Child Board is buried to deep from the initial board development, the system will refer to the parent board one layer up. So "Boards" are more reliable.
Since the Child board was buried to deep in the forum structure, you find that the example gives you a feed for the Parent "Board"
So lets, pick a board as an example - Forum/Thread Games:
Check the Address bar in your browser:
Again: all we are interested in is the Board and the Numbers:
Once again I am going to copy and paste "board=41.0" into my prepared URL:
So this: http://forums.bakabt.me/index.php?action=.xml;sa=recent;topic=22306.0;limit=20;type=rss2
Becomes this: http://forums.bakabt.me/index.php?action=.xml;sa=recent;board=41.0;limit=20;type=rss2
Now to test and see if the Feed work, we will copy and paste the new code into the Address bar and see if we get a correct feed.
Indeed we find that this works:
Final Notes.
As demonstrated above, it is always better to utilize a Board over a Topic, as the Board reference is reliable.
I know this has been a long road, but purposely done for a reason, so that you will understand all of the available options, actions, and consequences you will face as you develop your feed URL.
Experiment a bit, find the boards you want and the topics you desire, and see what works best, and what feeds you require to monitor, everything you need to know is in the tutorial just given.
I hope that the BakaBT members will find this of some use it targeting feeds to their individual needs.
If you have any questions, please do not hesitate to ask
Regards
The Sarge