Newsfeed - Help
If your questions are not addressed below, you can contact newsfeed at animenewsnetwork.com to get help.
To display the news on your website, there are 3 basic steps to follow:
-
Get the news using the getnews.php script
In order not to cause unnecessary load on our server, we ask that you only fetch the news once every hour or so. -
Save the news
In order to control bandwidth as well as who uses the newsfeed, the getnews.php script will only return text when something has changed from the last time. This means that you have to store (to a database or a file) what is returned by getnews.php in order to re-use it later. -
Display the stored news
Simply display the news you have stored in your database/file. In return for this service, the only thing we ask is that you also display the link "News provided by AnimeNewsNetwork.com" in your page. After all, there has to be something in this for us too, right? ;-)
Basically, you can use the script
http://animenewsnetwork.com/newsfeed/getnews.php?u=[username]&p=[password]
in whatever way you want, knowing that if the news have changed or if you saved your Newsfeed settings since the last time the script was called, it will return the number of news items you specified with the format you specified. So if getnews.php returns a blank page, just re-save your settings (it doesn't matter if nothing changed) and the next time the script is called it will return the news.
You can also filter news items by topic; for example to display only "Manga" and "Games" news:
http://animenewsnetwork.com/newsfeed/getnews.php?u=[username]&p=[password]&filter=manga,games
How The News Format Works
The format of the news items can contain several tags to customize how you wish the news to appear:
{ARTICLEURL}: URL for the full article (http://www.animenewsnetwork.com/article.php?id=...)
{TITLE}: Title of the article
{DATE}: Date when the article was posted, with format yyyy-mm-dd
{TIME}: Time when the article was posted, with format HH:MM:SS
{SHORTTEXT}: Short description that is displayed below each article title on ANN's main page
{TOPICS}: Comma-separated list of topics (as displayed on ANN's main page)
Additionally, there are some special tags to control the format depending on whether there is more to display than just the short description:
{IFMORE}...{ENDIF}: Text between the tags {IFMORE} and {ENDIF} will only be displayed if the news article contains MORE than the short description.
{IFNOMORE}...{ENDIF}: Text between the tags {IFNOMORE} and {ENDIF} will only be displayed if the news article contains ONLY the short description.
Example 0:
| Default format (same as ANN): |
|
Metropolis Manga from Dark Horse (2003-01-04 12:25:07) Melty Lancer 1 delayed (2003-01-04 12:15:59) ICv2 Anime Awards (2003-01-04 12:10:51) |
| Code for example 0: |
|
{IFMORE}{ENDIF}{TITLE} ({DATE}
{TIME}){IFMORE}{ENDIF} |
Example 1:
| Titles Only: |
|
Metropolis Manga from Dark Horse Melty Lancer 1 delayed ICv2 Anime Awards ADV Launches Wild Arms Website BESM Update Jakks picks up Dragonball License Noir DVD update Bandai to replace Arjuna DVDs New Sequential Tart Katsucon Announces Hiroaki Inoue |
| Code for example 1: |
|
{TITLE} |
| This example would be good if you wanted to put anime news in a side box on your website, instead of having a full size news page. |
Example 2:
| Title and date: |
|
Metropolis Manga from Dark Horse (2003-01-04) Melty Lancer 1 delayed (2003-01-04) ICv2 Anime Awards (2003-01-04) ADV Launches Wild Arms Website (2003-01-04) BESM Update (2003-01-04) Jakks picks up Dragonball License (2003-01-04) Noir DVD update (2003-01-03) Bandai to replace Arjuna DVDs (2003-01-03) New Sequential Tart (2003-01-03) Katsucon Announces Hiroaki Inoue (2003-01-03) |
| Code for example 2: |
|
{TITLE} ({DATE}) |
Example 3:
| Full Body Link: |
|
Metropolis Manga from Dark Horse (2003-01-04 12:25:07) Melty Lancer 1 delayed (2003-01-04 12:15:59) ICv2 Anime Awards (2003-01-04 12:10:51) |
| Code for example 3: |
|
{IFMORE}{ENDIF}{TITLE} ({DATE}
{TIME}){IFMORE}{ENDIF} |
| This one is similar to the default, but without the [More / No more] and the entire text is a link. |
Example 4:
| Each information on a row: |
|
http://www.animenewsnetwork.com/article.php?id=2998 Metropolis Manga from Dark Horse 2003-01-04 12:25:07 Due in April 1 http://www.animenewsnetwork.com/article.php?id=2997 Melty Lancer 1 delayed 2003-01-04 12:15:59 Bandai Entertainment has delayed the release of Melty Lancer DVD 1: Alpha to February 4th, 2003 for "Unforseeable circumstances." Source: TRSI 0 http://www.animenewsnetwork.com/article.php?id=2996 ICv2 Anime Awards 2003-01-04 12:10:51 ICv2 has posted an article about their Top Anime Company of 2002 (Bandai), Top Anime Product of the year (Love Hina), Top Anime Deal of the year (FUNimation/4kids distribution deal) and top phenomenon of the year (increased TV exposure). For their explainations of each topic, see their article at www.icv2.com. 0 |
| Code for example 4: |
|
{ARTICLEURL} {TITLE} {DATE} {TIME} {SHORTTEXT} {IFMORE}1{ENDIF}{IFNOMORE}0{ENDIF} |
| This can be used to get the raw data if you want to organize/process it using your own PHP script. |