====== News System (news) ======

Als Nachfolger von **tt_news** sehr zu empfehlen. Basiert auf Extbase und Fluid; sehr anpassungsfähig, komfortabel und umfangreich.

===== Standard-TypoScripts =====

<code typoscript>
plugin.tx_news {
  view {
    # Fallback, um einzelne Templates zu verändern:
    partialRootPaths >
    partialRootPaths {
      10 = EXT:news/Resources/Private/Partials/
      20 = EXT:templates/Resources/Private/Partials/tx_news/
    }
    templateRootPaths >
    templateRootPaths {
      10 = EXT:news/Resources/Private/Templates/
      20 = EXT:templates/Resources/Private/Templates/tx_news/
      # 30 könnte für Abweichungen verwendet werden, z.B. Einzelansicht bei Liste
    }
  }

  settings {
    # Geänderte CSS verknüpfen:
    cssFile = EXT:templates/Resources/Public/Css/tx_news.css
    
    # Platzhalterbild entfernen:
    displayDummyIfNoMedia = 0
    
    /*
    # Bildgrößen:
    detail.media.image.maxWidth = 200
    list.media.image.maxWidth = 110
    list.media.image.maxHeight = 
    */
    
    # rel-Attribut für Fancybox vergeben:
    # im Partial "FalMediaImage.html" muss für Fancybox auch die Klasse "fancybox" vergeben werden!
    detail.media.image.lightbox = fancybox
    
    # Social-Texte übersetzen:
    facebookLocale = de_DE
    googlePlusLocale = de
    disqusLocale = de
    
    # Social-Links entfernen:
    detail.showSocialShareButtons = 0
    
    list.paginate.itemsPerPage = 5
    
    # Datum in URL einfügen:
    link {
      skipControllerAndAction = 1
      hrDate = 1
      hrDate {
        day = j
        month = n
        year = Y
      }
    }
  }
}
</code>

===== TSconfig =====

<code>
# "In Vorschau-Ansichten anzeigen" immer aktiviert:
TCAdefaults.sys_file_reference.showinpreview = 1
</code>

----

===== Troubleshooting =====

==== Newsbeitrag nur in Fremdsprache (TYPO3 v9) ====

**Problem:** Unter TYPO3 v9 werden Beiträge nicht ausgegeben, die kein Eltern-Element in der Grundsprache besitzen.

**Workaround:** Hinzufügen der unteren Zeile in Datei ''Domain/Repository/AbstractDemandedRepository.php'', nach Zeile 99

<code php>
$query->getQuerySettings()->setLanguageOverlayMode(false); 
</code>

Quelle: https://github.com/georgringer/news/issues/815

----

==== Ausgabe in News-Einzelansichten auf gesetzten Ordner beschränken ====

Die News-Detailansichten geben erst einmal alle News-Datensätze aus, die sie übergeben bekommen. Hat man verschiedene Ordner mit Artikeln, die zwingend voneinander getrennt werden müssen, muss man im News-Plugin den Ausgangspunkt (''startingpoint'') setzen.

Für die Listenansichten genügt dies bereits. Damit aber auch die Detailansichten die gesetzten Ausgangspunkte berücksichtigen, muss noch die folgende Einstellung aktiviert werden:

<code typoscript>
plugin.tx_news.settings.detail.checkPidOfNewsRecord = 1
</code>

Erst dann gibt das Detail-Plugin wirklich nur die zugeordneten Datensätze aus. Bei allen anderen Artikeln folgt dann die Meldung //"Dieser Artikel ist nicht mehr verfügbar."//.

----

==== TYPO3 v9: News-Detailansicht mit robot-Tag 'index' ====

Sobald die News-Detailseite (sinnvollerweise) auf ''noindex'' gesetzt wurde, gilt diese Meta-Angabe auch für den dort angezeigten News-Datensatz. Das ist aber in den seltensten Fällen gewünscht.

Mit einer Condition kann man diese Meta-Angabe aber überschreiben. Das wird durch die [[https://docs.typo3.org/typo3cms/CoreApiReference/latest/ApiOverview/MetaTagApi/Index.html|MetaTag API]] in TYPO3 v9 unterstützt. Wichtig ist dabei die Eigenschaft ''replace''. Durch diese Vorgehensweise werden vorhandene Meta-Angaben einfach ersetzt und Duplikate verhindert.

<code typoscript>
[request.getQueryParams() ['tx_news_pi1'] > 0]
    page.meta.robots = index,follow
    page.meta.robots.replace = 1
[global]
</code>