Feeds i phpBB

Oversættelse af de kortfattede phpBB3 vejledninger m.m. og brugeres personlige bidrag
Besvar
Brugeravatar
jask
Hjemmeside Team Leder
Indlæg: 1187
Tilmeldt: 27. aug 2006 15:36
Geografisk sted: Odense
Kontakt:

Feeds i phpBB

Indlæg af jask » 22. jul 2010 19:33

En gennemgang af muligheder og indstillingerne i phpBB 3.0.x's ATOM feed. Forslag til ændringer og udbygning er velkomne.

Feed format
phpBB 3.0.x's feed er i ATOM format, IKKE RSS. Da ATOM ikke er særlig anvendt, kan nogle feed-læsere have problemer med at fortolke formatet korrekt. Der er ingen planer om at understøtte RSS-formatet i phpBB 3.x.

Hvor finder jeg og aktiverer feeds?
Gå i ACP -> Generel ->Feeds
1)I Generelle instillinger for feeds vælges "Aktiv" ud for "Feeds er:".
2)I Indlægsbaserede indstillinger vælges "Aktiv" ud for "Feeds for hele boardet:"
Efterlad resten af indstillingerne som de er, og klik på udfør nederst.
Når du returnerer til boardindekset, viser din browser nu et valgbart feed-ikon nær adresselinien, som åbner feedsiden. Eksempler på Internet Explorer 8
IEfeed.jpg
og Firefox 3.6
FFfeed.jpg
Åben feed via URL
Et eksempel på en URL som kan anvendes i en browser som understøtter feeds eller i en feedlæser: http://dinside.dk/phpbb/feed.php. Den præcise URL afhænger af din boardindstallation, i det feed.php er placeret i roden af phpbb-installationen.

Sikkerhed, adgang og kodeordbeskyttelse
Feedet viser fora svarende til brugers tilladelser. Hvis du ikke er logget ind, anvender feedet tilladelser for gæstebruger. Når du er logget ind, vil din browser huske tilladelserne og afgive disse til feedet i fremtiden. Indhold i fora beskyttet af kodeord vises under ingen omstændigheder.

Feed muligheder
Afhængig af om feeds er aktiveret, hvilke indstillinger der er valgt og hvilken side af boardet du ser på::
a) Browseren viser et feed-ikon
b) Et eller flere forskellige feeds kan vælges via feed-ikonets dropdownmenu
c) Feeds kan vælges med Url'en med et "get" parameter
De forskellige feedindstillinger gennemgås nedenfor:

Generelle instillinger for feeds
Feeds = Bestemmer om alle feeds overordnet er aktive eller ej. Feedtyper specificeres yderligere med andre indstillinger.

Elementstatistikker = Aktivering tilføjer forfatter, dato og tid for indlæg.

HTTP-autentifikation = Aktivering af muligheden for at åbne feedet med parameteret auth=http, som angives efter URL'en (URL = feed.php?auth=http).
Autentificeringen giver brugere mulighed for at udlevere brugerlegitimering (brugere tilmeldt dit board) for at åbne feedet. Feedet vil vise indhold svarende til brugertilladelser - f.eks forumindhold som ellers er skjult for gæster. De fleste feed-læsere har en mulighed for at angive brugernavn og kodeord i feedindstillingerne.

Kaldes feedet i en browser, med parameteret, åbnes en log ind dialog. Afhængig af den anvendte browser og version, kan det være muligt at angive brugerlegitimeringen i URL'en, f.eks: http://username:password@dinside.dk/php ... ?auth=http. Internet Explorer tillader ikke længere brugerlegitimering direkte i URL'en (se MS KB 834489), i Firefox startes en bekræftelsedialog.

Nogle webservere behøver en modificeret .htaccess-fil for at håndtere autentifikationen. Er det tilfældet findes filen i roden af din board-installation, fjern #-tegnene foran disse fire linier:

Kode: Vælg alt

<IfModule mod_rewrite.c>
RewriteEngine on
RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization},L]
</IfModule>

Indlægsbaserede indstillinger
Antal elementer = X (standard er 10).

Feeds for hele boardet = Feed med de X seneste indlæg fra alle emner i alle fora.
URL = feed.php

Feeds for enkeltfora = Feed med de X seneste indlæg fra alle emner i udvalgte fora.
URL = feed.php?f=[ForumID]

Feeds pr. emne = Feed med de X seneste indlæg fra udvalgte emne.
URL = feed.php?f=[ForumID]&t=[TopicID]

Emnebaserede indstillinger
Antal elementer = Y (standard 15).

Feeds for nye emner = Feed med det indlæg i de Y seneste emner i alle fora.
URL = feed.php?mode=topics

Feeds for aktive emner = Feed med Y seneste indlæg som ikke er ældre end 7 dage, i fora som har "Vis aktive emner" aktiveret.
URL = feed.php?mode=topics_active
7 dage = konfigureret i feed.php (kan ændres i denne fil, se nedenstående).

Kode: Vælg alt

var $sort_days = 7;
Genupload efterfølgende den ændrede feed.php-fil, og genopfrisk din browsers cache.

Nyheds-feeds = Feed med første indlæg i valgte fora.
URL = feed.php?mode=news

Andre feeds og indstillinger
Forum-feeds = Feed med liste over alle fora (ikke indholdet) du har adgang til, men inklusive eventuelle fora beskyttet af kodeord.
URL = feed.php?mode=forums

Ekskluder disse fora = Fora der skal ekskluderes i ethvert feed.

Vis feed-ikon i ikke standardtypografier
Hvis du anvender en anden typografi end prosilver, subsilver2 eller prosilver special edition, er du nød til at ændre i filen overall_header.php placeret /styles/dintypografi/template for at inkludere aktivering med feed-ikon:
Find:

Kode: Vælg alt

<title>{SITENAME} &bull; <!-- IF S_IN_MCP -->{L_MCP} &bull; <!-- ELSEIF S_IN_UCP -->{L_UCP} &bull; <!-- ENDIF -->{PAGE_TITLE}</title>
Tilføj efter:

Kode: Vælg alt

<!-- IF S_ENABLE_FEEDS -->
       <!-- IF S_ENABLE_FEEDS_OVERALL --><link rel="alternate" type="application/atom+xml" title="{L_FEED} - {SITENAME}" href="{U_FEED}" /><!-- ENDIF -->
       <!-- IF S_ENABLE_FEEDS_NEWS --><link rel="alternate" type="application/atom+xml" title="{L_FEED} - {L_FEED_NEWS}" href="{U_FEED}?mode=news" /><!-- ENDIF -->
       <!-- IF S_ENABLE_FEEDS_FORUMS --><link rel="alternate" type="application/atom+xml" title="{L_FEED} - {L_ALL_FORUMS}" href="{U_FEED}?mode=forums" /><!-- ENDIF -->
       <!-- IF S_ENABLE_FEEDS_TOPICS --><link rel="alternate" type="application/atom+xml" title="{L_FEED} - {L_FEED_TOPICS_NEW}" href="{U_FEED}?mode=topics" /><!-- ENDIF -->
       <!-- IF S_ENABLE_FEEDS_TOPICS_ACTIVE --><link rel="alternate" type="application/atom+xml" title="{L_FEED} - {L_FEED_TOPICS_ACTIVE}" href="{U_FEED}?mode=topics_active" /><!-- ENDIF -->
       <!-- IF S_ENABLE_FEEDS_FORUM and S_FORUM_ID --><link rel="alternate" type="application/atom+xml" title="{L_FEED} - {L_FORUM} - {FORUM_NAME}" href="{U_FEED}?f={S_FORUM_ID}" /><!-- ENDIF -->
       <!-- IF S_ENABLE_FEEDS_TOPIC and S_TOPIC_ID --><link rel="alternate" type="application/atom+xml" title="{L_FEED} - {L_TOPIC} - {TOPIC_TITLE}" href="{U_FEED}?f={S_FORUM_ID}&t={S_TOPIC_ID}" /><!-- ENDIF -->
    <!-- ENDIF -->
Tøm herefter boardets cache og genfrisk din browsers cache.

Tilføj feed-ikon i boardets header
I filen /styles/dintypografi/template/overall_header.php:
Find:

Kode: Vælg alt

<li class="icon-home"><a href="{U_INDEX}" accesskey="h">{L_INDEX}</a> <!-- BEGIN navlinks --> <strong>&#8249;</strong> <a href="{navlinks.U_VIEW_FORUM}">{navlinks.FORUM_NAME}</a><!-- END navlinks --></li>
Tilføj efter:

Kode: Vælg alt

<!-- IF S_ENABLE_FEEDS --><li class="rightside"><a type="application/rss+xml" href="{U_FEED}"><img src="feed-icon-14x14.png" alt="{L_FEED} - {SITENAME}" title="{L_FEED} - {SITENAME}" /></a></li><!-- ENDIF -->
Tøm herefter boardets cache og genfrisk din browsers cache.
Bemærk at grafikfilen "feed-icon-14x14.png" skal være uploaded til dit system og stien angivet korrekt.

Tilføj feed-ikon i forumlisten for typografier baseret på prosilver
I filen styles/prosilver/template/forumlist_body.html:
Find:

Kode: Vælg alt

<!-- IF S_ENABLE_FEEDS and forumrow.S_FEED_ENABLED --><!-- <a class="feed-icon-forum" title="{L_FEED} - {forumrow.FORUM_NAME}" href="{U_FEED}?f={forumrow.FORUM_ID}"><img src="{T_THEME_PATH}/images/feed.gif" alt="{L_FEED} - {forumrow.FORUM_NAME}" /></a> --><!-- ENDIF -->
Erstat med:

Kode: Vælg alt

<!-- IF S_ENABLE_FEEDS and forumrow.S_FEED_ENABLED --><a class="feed-icon-forum" title="{L_FEED} - {forumrow.FORUM_NAME}" href="{U_FEED}?f={forumrow.FORUM_ID}"><img src="{T_THEME_PATH}/images/feed.gif" alt="{L_FEED} - {forumrow.FORUM_NAME}" /></a> <!-- ENDIF -->
kilde: http://www.phpbb.com/community/viewtopi ... &t=2029415

Brugeravatar
Stoker
Indlæg: 95
Tilmeldt: 20. jun 2008 19:11
Kontakt:

Re: Feeds i phpBB

Indlæg af Stoker » 11. aug 2010 20:08

Man kan også nemt tilføje et feed ikon på forum og emnesiderne.

Forum
Åben styles/prosilver/template/viewforum_body.html
Find:

Kode: Vælg alt

<!-- INCLUDE overall_header.html -->
Tilføj efter:

Kode: Vælg alt

<!-- IF S_ENABLE_FEEDS and S_ENABLE_FEEDS_FORUM and S_FORUM_ID -->
<a class="feed-icon-forum" title="{L_FEED} - {FORUM_NAME}" href="{U_FEED}?f={S_FORUM_ID}"><img src="{T_THEME_PATH}/images/feed.gif" title="{L_FEED} - {FORUM_NAME}" alt="{L_FEED}" /></a>
<!-- ENDIF -->

Emner
Åben styles/prosilver/template/viewtopic_body.html
Find:

Kode: Vælg alt

<!-- INCLUDE overall_header.html -->
Tilføj efter:

Kode: Vælg alt

<!-- IF S_ENABLE_FEEDS and S_ENABLE_FEEDS_TOPIC and S_TOPIC_ID -->
<a class="feed-icon-forum" title="{L_FEED} - {TOPIC_TITLE}" href="{U_FEED}?f={S_FORUM_ID}&t={S_TOPIC_ID}"><img src="{T_THEME_PATH}/images/feed.gif" title="{L_FEED} - {TOPIC_TITLE}" alt="{L_FEED}" /></a>
<!-- ENDIF -->
Man kan altid diskutere hvor brugbart det er. Det indsætter blot et feed ikon til højre for overskrifterne og det er alligevel tilgængeligt oppe i browserens adresse felt.

Brugeravatar
Jan
Anerkendt medstifter
Indlæg: 878
Tilmeldt: 23. aug 2006 19:01

Re: Feeds i phpBB

Indlæg af Jan » 11. aug 2010 20:14

Takker for inputtet :)

Det gør det, om ikke andet, mere synligt i hvert fald :)

Besvar