Conas Tagairtí Saincheaptha a Chur le Postáil WordPress (le Gearrchóid agus Plugin Saor In Aisce)
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.

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ó.

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.

Céim 4: Cuir Tooltip CSS agus JavaScript leis

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 🙂