Conas Tagairtí Saincheaptha a Chur le Postáil WordPress (le Gearrchóid agus Plugin Saor In Aisce)

San alt seo
    Add a header to begin generating the table of contents

    Réamhrá do Luanna WordPress

    D’fhéadfadh sé a bheith riachtanach luanna agus tagairtí a chur le postálacha WordPress do shuíomhanna gréasáin a láimhseálann ábhar acadúil nó tionscadail taighde. Sa bhlag seo, beidh tú ag foghlaim conas córas lua saincheaptha a chruthú i WordPress, le leideanna uirlisí agus liosta tagartha, ag baint úsáide as shortcodes agus cód PHP simplí.

    Chruthaigh mé é seo le haghaidh tionscadal foinse oscailte ar a dtugtar The Énrí Ó Muirgheasa Project, which documents the author’s research on Irish song and culture, including “Dhá Chéad de Cheoltaibh Uladh” (Two Centuries of Ulster Song). Fágann an modh seo go bhfuil sé éasca luanna agus tagairtí a bhainistiú thar shuíomhanna WordPress, go háirithe le haghaidh taighde fairsing nó blaganna acadúla.

    Maighre Dheas na Gruaige Báine - Dhá Chéad de Cheoltaibh Uladh
    Féach luanna, leathanach ar dheis ag bun.

    Céim 1: Cruthaigh gearrchód don lua

    Tá gearrchód comhlua an-oiriúnach chun tagairtí a mharcáil ar fud d'inneachair, rud a fhágann go bhfuil sé éasca luanna a chur isteach agus a thaispeáint. Cruthóimid gearrchód dar teideal [cite] a úsáid cibé áit a dteastaíonn lua uainn.

    // Citation Shortcode
    function simplest_citations_cite_shortcode($atts, $content = null) {
        static $cite_count = 0;
        $cite_count++;
    
        // Store the citation content for tooltip and [citelist] shortcode
        global $citelist;
        $citelist[$cite_count] = $content;
    
        // Citation link with tooltip data
        $cite_link = '<sup><a href="#cite-' . $cite_count . '" id="cite-link-' . $cite_count . '" class="cite-tooltip" data-tooltip="' . esc_attr($content) . '">[' . $cite_count . ']</a></sup>';
        
        return $cite_link;
    }
    add_shortcode('cite', 'simplest_citations_cite_shortcode');

    Cláraíonn an cód seo an "shortcode" [cite] , a choinníonn súil ar gach uimhir lua sa phost agus a shanntar leid uirlisí uathúil dó.

    Sampla Úsáide

    Cuir [cite]Téacs lua anseo[/cite] in aice leis an téacs ar mhaith leat tagairt a dhéanamh dó.

    Citation shortcode in WordPress Gutenberg editor
    Citation shortcode in WordPress Gutenberg editor

    Céim 2: Cruthaigh Gearrchód Liosta Lua

    Anois, cruthaímid "shortcode" [citelist] chun gach lua ag deireadh d'ábhar a aschur. Lúbfaidh sé seo trí gach lua a chruthófar agus taispeánfar iad i liosta ordaithe.

    // Citation List Shortcode
    function simplest_citations_citelist_shortcode() {
        global $citelist;
        $output = '<ol class="citation-list">';
    
        foreach ($citelist as $num => $citation) {
            $output .= '<li id="cite-' . $num . '">' . $citation . ' <a href="#cite-link-' . $num . '">[Back]</a></li>';
        }
    
        $output .= '</ol>';
        return $output;
    }
    add_shortcode('citelist', 'simplest_citations_citelist_shortcode');

    Céim 3: Cuir an Liosta Lua i gceangal leis go huathoibríoch

    Chun é seo a dhéanamh níos so-úsáidte, cuirfimid an liosta lua go huathoibríoch i ndiaidh an ábhair mura n-úsáidtear [citelist] go sainráite sa phostáil.

    // Auto Append Citation List
    function simplest_citations_append_citelist($content) {
        global $citelist;
    
        if (!empty($citelist) && strpos($content, '[citelist]') === false) {
            $content .= '<h3>Citations</h3>[citelist]';
        }
    
        return $content;
    }
    add_filter('the_content', 'simplest_citations_append_citelist');

    Seiceálann an scagaire seo an bhfuil luanna i láthair agus mura n-úsáidtear [citelist] de láimh; má tá, cuireann sé ceannteideal “Citations” leis an liosta.

    Lua a chuirtear go huathoibríoch le hábhar deireadh an phoist, le cúlshúil gearrchód.

    Céim 4: Cuir Tooltip CSS agus JavaScript leis

    Wiki-style tooltip citation for WordPress
    Lua leid uirlisí ar stíl Vicí le haghaidh WordPress

    Ar mhaithe le UX níos fearr, stíleoimid na luanna le leid uirlisí a thaispeánfar nuair a ainlíonn úsáideoirí anuas orthu.

    /* Tooltip CSS */
    .cite-tooltip {
        position: relative;
        text-decoration: none;
        cursor: pointer;
    	font-size: 0.8em;
    }
    
    .cite-tooltip::after {
        content: attr(data-tooltip);
        position: absolute;
        top: -80px;
        left: 50%;
        transform: translateX(-50%);
        width: max-content;
        max-width: 250px;
        background: rgba(0, 0, 0, 0.8);
        color: #fff;
        padding: 5px 10px;
        border-radius: 5px;
        font-size: 12px;
        display: none;
        z-index: 1000;
    }
    
    .cite-tooltip:hover::after {
        display: block;
    }

    Leideanna JavaScript (jQuery)

    Cinntíonn an JavaScript seo go dtaispeánann an téacs leid uirlisí i gceart ar ainlíon.

    (function($) {
        'use strict';
    
        $(document).ready(function() {
            const citeLinks = $('.cite-tooltip');
    
            citeLinks.each(function() {
                $(this).on('mouseenter', function() {
                    const tooltip = $(this).data('tooltip');
                    $(this).attr('title', tooltip);
                });
    
                $(this).on('mouseleave', function() {
                    $(this).removeAttr('title');
                });
            });
        });
    
    })(jQuery);

    Íoslódáil agus Leathnaigh

    Is pointe tosaigh maith é an struchtúr breiseán bunúsach seo. Is féidir leat é a íoslódáiltriail a bhaint as ar do shuíomh WordPress, agus é a shaincheapadh a thuilleadh de réir mar is gá. Má tá suim agat an breiseán seo a leathnú nó má tá aon aiseolas agat, ná bíodh drogall ort teagmháil a dhéanamh!

    Tá súil againn an breiseán seo a leathnú tuilleadh agus é a chur ar fáil saor in aisce i stór neamhspleách 🙂

    Postáilte i ,

    CLÁRAIGH ANOIS LE hAGHAIDH ACMHAINNÍ SAOR IN AISCE

    Breiseáin WooCommerce nua, acmhainní gnó agus gearrthóga Shopify díreach chuig d'inbhosca.
    Something went wrong. Please check your entries and try again.

    Robert McMillen

    Tá suíomhanna gréasáin ríomhthráchtála á bhforbairt ag Robert McMillen le beagnach dhá scór bliain. Faoi láthair tá sé ina stiúrthóir ar The Web Co. agus oibríonn sé mar chomhairleoir scópála le gníomhaireachtaí in Éirinn, sa Bhreatain agus sna Stáit Aontaithe.

    Fág Trácht