Twoday-Tipp #9 - Thalia Büchersuche repariert

thalia/thaliarepair.jpg

Datum Änderungen / Edits
27.01.2016 Anpassung der Büchersuche aufgrund struktureller Änderungen auf der thalia.at Webseite. Die aktualisierte Version 1.1 des Skins (module.modReadingSetup-v11.txt) muss neu installiert werden.

Beginnen wir mit einer Preisfrage: Was haben die Twoday-Büchersuche über Thalia.at und Amazon.de gemeinsam? Stimmt! Beide existierten einmal, aber keine davon funktioniert noch. Und trotz regelmäßiger Forumnachfrage sind Bemühungen zur baldigen Behebung des Dauer­brenners derzeit nicht erkennbar. Zeit, das Thema selbst in die Hand zu nehmen und auch ohne Server-Zugriff eine brauch­bare anwender­seitige Lösung zu schaffen.

Vor einigen Jahren hat Amazon bereits seine Bücher-/Produkt­suche für "normalen" Programmier­zugriff geschlossen. Für die Nutzung des Product Advertising APIs sind seither spezielle An­mel­dungen, Partner-IDs und Zugriffs­schlüssel erforderlich, was für eine Blog­plattform wenig Sinn macht, zumal die Anzahl der erlaubten Zugriffe limitiert ist. Bleibt also Thalia.at, die ihrer kürzlich neu entworfenen Webseite auch eine detaillierte, von außen ansteuerbare Suchfunktion spendiert haben.

Neue Büchersuche installieren

Das Skin module.modReadingSetup

Wie schon die alte Twoday-Standard-Büchersuche liegt auch die neue Funktion im Skin module.modReadingSetup. Im Gegensatz zu vielen anderen Skins, die über die Navigation AdminLayoutSkins (HTML) angesteuert und angepasst werden können, entzieht sich der für die Büchersuche zuständige Skin jedoch einem schnellen Zugriff. Um ihn ändern zu können, bedarf es der Anwendung eines kleinen Kniffs.

  1. Laden Sie zunächst einmalig den zukünftigen Inhalt des Büchersuche-Skins herunter. Klicken Sie dazu auf die nachfolgende Schaltfläche und speichern Sie die Textdatei in einem beliebigen Verzeichnis Ihrer Festplatte.

     module.modReadingSetup-v11.txt

  2. Öffnen Sie die Datei in einem Texteditor (z.B. Notepad, Notepad++, Wordpad, TextEdit) als reine Textdatei, markieren Sie den gesamten Inhalt (Strg-A für Windows, Cmd-A für Mac) und kopieren Sie diesen in die Zwischenablage (Strg-C für Windows, Cmd-C für Mac). Schließen Sie danach den Editor.

    thalia/thalia00.jpg

  3. Melden Sie sich auf Twoday mit Ihrem Account an und rufen Sie Ihr Blog auf.
  4. Wählen Sie in der Menüzeile oben AdminLayout und dann Skins (HTML)Falls Sie Ihre Menüzeile ausgeblendet haben, erreichen Sie die Skin­bearbeitung alternativ auch durch direkte Eingabe der Adresse https://blogalias.twoday.net/layouts (blogalias = Ihr Blogname) und dann durch Klick auf Skins (HTML).
  5. Klicken Sie dort auf ein beliebiges Skin. Im Beispiel verwenden wir das Skin Dayheader (Story.dayheader). Es ist aber nicht wirklich wichtig, welches Skin verwendet wird, weil es nur als Vorlage für die Adresse dient.

    thalia/thalia01.jpg

  6. Oben in der Adresszeile des Browsers wird nun folgende Zeichenkette angezeigt — natürlich mit Ihrem Blogalias und Layoutnamen:

    thalia/thalia02.jpg

  7. Markieren Sie den gesamten Rest hinter key= und schreiben Sie stattdessen module.modReadingSetup hinter das Gleichheitszeichen:

    thalia/thalia03.jpg

  8. Betätigen Sie die Datenfreigabetaste (Return), um den bisherigen Inhalt des Skins module.modReadingSetup anzuzeigen. Klicken Sie in das Feld mit dem Scrollbalken und markieren den gesamten Inhalt des Skins (Strg-A für Windows, Cmd-A für Mac):

    thalia/thalia04.jpg

  9. Fügen Sie nun den neuen Büchersuche-Inhalt (welcher sich seit Schritt 2 in Ihrer Zwischenablage befindet) in das Textfeld ein und ersetzen damit den markierten alten Inhalt vollständig (Strg-V für Windows, Cmd-V für Mac):

    thalia/thalia05.jpg

    Klicken Sie abschließend auf Speichern und Schließen um Ihre Änderung zu sichern.

    Gratulation! Die neue Suchfunktion über Thalia.at ist nun installiert. Im folgenden Kapitel lesen Sie, wie Sie die neue Büchersuche ab sofort verwenden können.

Büchersuche flexibel einsetzen

Büchersuche aufrufen

  1. Klicken Sie im Übersichtsbildschirm auf Module.

    thalia/thalia06.jpg

  2. Klicken Sie beim Eintrag "Bücherliste" auf Einstellungen.

    thalia/thalia07.jpg

  3. Unter der Überschrift Nach neuen Büchern suchen finden Sie den überarbeiteten Teil der Büchersuche, die nun über die Thalia.at Webseite erfolgt:

    thalia/thalia08.jpg

    Ein Büchersuche kann prinzipiell einfach oder strikt durchgeführt werden. Bei der einfachen Suche können Sie in jedem der beiden Eingabefelder beliebige, gemischte Suchwörter eingeben, unabhängig davon, ob sie zum Titel oder Autorennamen gehören. Bei der strikten Suche müssen die Suchwörter für Titel und Autor getrennt eingegeben werden. Standardmäßig ist die einfache Suche aktiviert (empfohlen).

  4. Einfache Suche
    Tippen Sie Nick Cave Munro in das Buchtitelfeld und klicken Sie anschließend auf die Jetzt auf Thalia.at suchen-Schaltfläche.
  5. Ein grafischer Indikator zeigt Ihnen an, dass die Suche gestartet ist. Nach kurzer Zeit werden die Suchergebnisse angezeigt. Jedes von Thalia gefundene Ergebnis wird in einem eigenen Kasten aufbereitet. Ein Klick auf das Buch führt direkt zur Webseite und weiteren Informationen.

    thalia/thalia09.jpg

    Um mehrfache Ergebnisse zu reduzieren, können Sie einen bestimmten Produkttyp einstellen, z.B. nur Bücher, oder nur eBooks, oder nur Hörbücher.

  6. Strikte Suche
    Für eine exakte Suche aktivieren Sie das Auswahlkästchen "Strikte Suche". Damit wird es erforderlich, Suchwörter strikt nach Titel bzw. Autorenname aufzuteilen. Beispiel: Tippen Sie Argo in das Titelfeld und Herbst in das Autorenfeld.

    thalia/thalia10.jpg

    Es kommt vor, dass Thalia bei der strikten Suche keine Suchergebnisse zurückliefert. Verwenden Sie dann die einfache Suche.

  7. Haben Sie Ihr gewünschtes Buch gefunden, können Sie es mit einem Klick auf das Pluszeichen automatisch in das Twoday-Eintragsformular übernehmen.

    thalia/thalia11.jpg

  8. Titel, Autor, Link und Bild werden in das Formular übernommen. Klicken Sie auf Hinzufügen, um das Buch endgültig in Ihre Bücherliste zu übernehmen.

    thalia/thalia12.jpg

  9. Alle Titel in Ihrer Bücherliste können Sie nach eigenen Wünschen umsortieren. Zum Abschluss klicken Sie auf Sichern um die Änderungen dauerhaft zu speichern.

    thalia/thalia13.jpg

Bücherliste in der Seitenleiste anzeigen

Das Modul "Bücherliste" in die Sidebar integrieren

Damit Ihre Bücherliste in der Seitenleiste Ihres Blogs angezeigt wird, sind folgende Schritte erforderlich:

  1. Klicken Sie in Ihrer Blog-Menüzeile oben auf AdminModule und dann auf Sidebar Module anordnen.Falls Sie Ihre Menüzeile ausgeblendet haben, erreichen Sie die Modul­anordnung alternativ auch durch direkte Eingabe der Adresse https://blogalias.twoday.net/modules/order (blogalias = Ihr Blogname).

    thalia/thalia14.jpg

  2. Wählen Sie das Büchermodul aus (im Twoday-Standard hat dies die Textbezeichnung "Mein Lesestoff") und übertragen Sie es durch Klick auf die entsprechende Schaltfläche in die erste (Sidebar 1) oder zweite (Sidebar 2) Seitenleiste.

    thalia/thalia15.jpg

  3. Nachdem Sie das Büchermodul eingefügt haben, speichern Sie ihre Änderung durch Klick auf Sichern.

    thalia/thalia16.jpg

  4. Klicken Sie auf Weblog ansehen, um die Anzeige des Büchermoduls zu kontrollieren.

    thalia/thalia17.jpg

    In der Seitenleiste werden nun die übernommenen Buchtitel angezeigt. Die Coverbilder haben teilweise unterschiedliche Größen und Titel/Autor sind sehr klein formatiert. Im folgenden Kapitel lesen Sie, wie Sie die Bücher nach Ihren Wünschen formatieren können.

    thalia/thalia18.jpg

Bücher in der Seitenleiste formatieren

Drei weitere Skins anpassen

Für die optische Aufbereitung der Bücherliste sind drei weitere Skins verantwortlich: Site.modReadingItem für den einzelnen Buchtitel, Site.modReadingDivider für den Trennbereich zwischen zwei Büchern und Site.modReading für den gesamten Container der Bücherliste. Die Skins sind sehr schnell und einfach anzupassen.

  1. Klicken Sie in Ihrer Blog-Menüzeile oben auf AdminModule.Falls Sie Ihre Menüzeile ausgeblendet haben, erreichen Sie die Modul­liste alternativ auch durch direkte Eingabe der Adresse https://blogalias.twoday.net/modules/sidebar (blogalias = Ihr Blogname).

    Klicken Sie im Eintrag Bücherliste auf Skins.

    thalia/thalia19.jpg

  2. Alle drei Skins benötigen kleine Anpassungen, um die einzelnen Bestandteile einer Buchtitelanzeige zukünftig besser formatieren zu können.

    thalia/thalia20.jpg

    Die Zahlen oben markieren die Reihenfolge der Änderungen. Klicken Sie also zunächst auf den Skin Site.modReadingItem.

  3. Markieren und kopieren Sie die nachstehenden Zeilen in die Zwischenablage, wechseln Sie in den geöffneten Skin Site.modReadingItem und ersetzen dort den gesamten Inhalt.
    <div class="sbBookItem">
        <% param.ReadingImage %>
        <div class="sbBookAuthor"><% param.ReadingAuthor %></div>
        <div class="sbBookTitle"><% param.ReadingTitle %></div>
    </div>

    Alter Inhalt

    thalia/thalia21.jpg

    Neuer Inhalt

    thalia/thalia22.jpg

    Klicken Sie auf Speichern und Schließen, um die Änderung zu sichern.

  4. Klicken Sie nun auf Site.modReadingDivider und entfernen Sie den gesamten Inhalt des Skins (im Standard ist dies ein einzelnes <br />).

    Alter Inhalt

    thalia/thalia23.jpg

    Neuer Inhalt

    thalia/thalia24.jpg

    Klicken Sie auf Speichern und Schließen, um diese Änderung zu sichern.

  5. Klicken Sie nun auf Site.modReading. Markieren/kopieren Sie die nachstehenden Zeilen in die Zwischenablage, wechseln Sie in den geöffneten Skin und ersetzen dort den gesamten Inhalt.
    <style>
    .sbBookContainer {}
    .sbBookItem { margin-bottom: 20px; font-size: 13px; }
    .sbBookItem img { box-shadow: 3px 4px 6px #ccc; max-height: 120px; }
    .sbBookAuthor { font-style: italic; margin-top: 10px; }
    .sbBookTitle {}
    </style>
    <div class="sbBookContainer">
        <% param.Reading %>
    </div>

    Alter Inhalt

    thalia/thalia25.jpg

    Neuer Inhalt

    thalia/thalia26.jpg

    Klicken Sie auf Speichern und Schließen, um auch diese Änderung zu sichern.

  6. Klicken Sie auf Weblog ansehen, um sich das Ergebnis der Änderungen anzusehen.

    thalia/thalia27.jpg

    Die im Skin Site.modReading definierten Formatanweisungen (CSS-Stile) haben folgendes bewirkt:

    .sbBookItem { margin-bottom: 20px; font-size: 13px; } definiert für jedes Buch einen unteren Abstand von 20 Pixel und stellt eine Zeichensatzgröße von 13 Pixel ein.

    .sbBookItem img { box-shadow: 3px 4px 6px #ccc; max-height: 120px; } erzeugt einen schmalen Schatten um das Buchcover und stellt die Höhe des Bildes auf maximal 120 Pixel ein (die Breite wird automatisch proportional angepasst).

    .sbBookAuthor { font-style: italic; margin-top: 10px; } stellt den Autorennamen in Kursiv dar und definiert einen oberen Abstand (zum Coverbild) von 10 Pixeln.

    Diese Vorbelegungen lassen sich jederzeit nach eigenen Wünschen anpassen. Rufen Sie dazu erneut den Skin Site.modReading auf und passen Sie die Stildefinitionen entsprechend an.
Probleme, Fragen, Ergänzungswünsche?

Falls Sie Probleme mit der Büchersuche bemerken, posten Sie diese bitte zusammen mit einem Screen­shot in die Kommentare.

Wichtiger Hinweis: Der Zugriff auf die Thalia.at Suchfunktion erfolgt über ein technisches Werkzeug (YQL), das von Yahoo bereitgestellt wird. Bei starker weltweiter Nutzung kann eine Überlastungssituation eintreten, in der das Tool keine Ergebnisse zurückmeldet. Wiederholen Sie dann einfach Ihre Suchabfrage.

Um diesen Beitrag zu drucken, klicken Sie bitte in der Menüzeile oben rechts auf das Druckersymbol

module.modReadingSetup, site.modReading/modReadingItem/modReadingDivider © 2015 NeonWilderness — lizensiert unter MIT.
Außergewöhnliches
Dinge, die gut sind
Entgleisungen
Gemalte Lebenserfahrung
Musik
Nachtgedanken
Neon-Award
Neon's Must-Have-Tools
Neon's Top10 List
Schöner Bloggen
Today I Learned
Wort des Tages
Profil
Abmelden
Weblog abonnieren
Meine Layouts
Meine bearbeiteten Skins
Hauptseite (Site.page)
Toolbar (Site.foundationToolbar)
Github Neon
Gitlab twoday.net
Font Awesome Cheatsheet v4