4,'tablet_columns'=>2,'mobile_columns'=>1,'gap'=>20,'title_size'=>19,'title_lines'=>3,
'image_ratio'=>'3:2','show_excerpt'=>false,'show_author'=>false,'card_style'=>'outlined');
foreach(array('columns'=>array(1,4),'tablet_columns'=>array(1,3),'mobile_columns'=>array(1,2),'gap'=>array(8,40),'title_size'=>array(16,28),'title_lines'=>array(2,5)) as $key=>$range){
$out[$key]=(int)wtxs_num($v[$key]??$out[$key],$out[$key],$range[0],$range[1]);
}
$out['image_ratio']=wtxs_enum($v['image_ratio']??null,array('16:9','3:2','4:3'),'3:2');
$out['card_style']=wtxs_enum($v['card_style']??null,array('outlined','soft','bare'),'outlined');
foreach(array('show_excerpt','show_author') as $key){$out[$key]=wtxs_bool($v[$key]??false);}
return $out;
}
function wtx143_settings($out,$in) {
$out['publishing']['card_palette']=wtx143_palette($in['publishing']['card_palette']??array());
$out['publishing']['related_design']=wtx143_related_design($in['publishing']['related_design']??array());
return $out;
}
/** Some legacy subtitle filters append tags, occasionally entity-encoded, to the title. */
function wtx143_plain_text($text) {
if(!is_scalar($text)){return '';}
$text=(string)$text;
for($i=0;$i<2;$i++){$decoded=html_entity_decode($text,ENT_QUOTES|ENT_HTML5,'UTF-8');if($decoded===$text){break;}$text=$decoded;}
$text=wp_strip_all_tags($text);
return trim(preg_replace('/\s+/u',' ',$text)??'');
}
function wtx143_post_title($post) {
$title=wtx143_plain_text(get_the_title($post));
return $title!==''?$title:wtx_t('Untitled story','مقال دون عنوان');
}
/** Only this template's heading changes. Taxonomy labels, slugs, URLs and SEO titles are untouched. */
function wtx143_archive_title($before='',$after='
') {
if(function_exists('wtx150_title')&&($title=wtx150_title())!==null){echo $before.esc_html($title).$after;return;}
$s=wtxs_data();$hide=!empty($s['publishing']['archive_design']['hide_prefix']);
if($hide&&(is_category()||is_tag()||is_tax())){$title=esc_html(wtx143_plain_text(single_term_title('',false)));}
elseif($hide&&is_post_type_archive()){$title=esc_html(wtx143_plain_text(post_type_archive_title('',false)));}
else{$title=get_the_archive_title();}
if($title!==''){echo $before.$title.$after;}
}
/** A custom article taxonomy is not a standard category; do not silently fall through to news cards. */
function wtx143_article_tax_archive($type) {
if(!$type||$type==='post'||!is_tax()){return false;}
$term=get_queried_object();
return is_object($term)&&!empty($term->taxonomy)&&is_object_in_taxonomy($type,$term->taxonomy);
}
/** Failure fallback is inert local markup, never copied from an arbitrary URL. */
function wtx143_missing_media($attrs=array(),$article=false) {
$fallback=wtx131_fallback_image($attrs,$article);
return $fallback;
}
function wtx143_guard_media($html,$attrs=array(),$article=false) {
if(!is_string($html)||$html===''){return wtx143_missing_media($attrs,$article);}
$backup=wtx143_missing_media($attrs,$article);
return ''
.''.$html.''
.''.$backup.'';
}
/** Reuse the caller's related query. Public/password guards are rechecked without changing the source query. */
function wtx143_related_section($posts,$title='') {
$valid=array();foreach((array)$posts as $p){
if(is_object($p)&&isset($p->ID)&&get_post_status($p->ID)==='publish'&&empty($p->post_password)&&!post_password_required($p->ID)){$valid[]=$p;}
}
if(!$valid){return '';}
$s=wtxs_data();$d=wtx143_related_design($s['publishing']['related_design']??array());$n=count($valid);
$vars='--wtx-related-columns:'.min($n,$d['columns']).';--wtx-related-tablet:'.min($n,$d['tablet_columns']).';--wtx-related-mobile:'.min($n,$d['mobile_columns']).';';
$html='';
}
/** Custom colors are scoped to an individual surface. Empty means inherit; dark is independent. */
function wtx143_palette_css($selector,$input) {
$p=wtx143_palette($input,true);$css='';
foreach(array('light','dark') as $mode){
$vars='';foreach(array('heading','title','hover','excerpt','meta') as $role){
$key=($mode==='dark'?'dark_':'').$role.'_color';
// Reset the light override in dark mode. Do not leak navy text onto a dark surface.
if(!empty($p[$key])){$vars.='--wtx-ink-'.$role.':'.$p[$key].';';}
}
if($vars){$css.=($mode==='dark'?'html[data-mode="dark"] ':'html:not([data-mode="dark"]) ').$selector.'{'.$vars.'}';}
}
return $css;
}
function wtx143_publication_css($s) {
$p=$s['publishing']['card_palette']??array();$d=wtx143_related_design($s['publishing']['related_design']??array());
$css=wtx143_palette_css('body',$p);
$css.='.wtx-related{--wtx-related-gap:'.$d['gap'].'px;--wtx-related-title:'.$d['title_size'].'px;--wtx-related-lines:'.$d['title_lines'].';--wtx-related-ratio:'.str_replace(':','/',$d['image_ratio']).';}';
$css.='@media(max-width:'.(int)$s['tokens']['tablet'].'px){.wtx-related>.wtx-related-items{grid-template-columns:repeat(var(--wtx-related-tablet,2),minmax(0,1fr));}}';
$css.='@media(max-width:'.(int)$s['tokens']['mobile'].'px){.wtx-related>.wtx-related-items{grid-template-columns:repeat(var(--wtx-related-mobile,1),minmax(0,1fr));}}';
return $css;
}
add_action('wp_enqueue_scripts',static function(){
// Tiny dependency-free safety layer. Loaded before footer images can report failure, and rescans completed images.
wp_enqueue_style('witarix-publication-layouts',get_template_directory_uri().'/assets/studio/publication-layouts.css',array('witarix-layout'),WITARIX_VERSION);
wp_enqueue_script('witarix-media-resilience',get_template_directory_uri().'/assets/studio/media-resilience.js',array(),WITARIX_VERSION,true);
},58);
function wtx143_media_is_placeholder($html) {
return is_string($html)&&strpos($html,'.wtx-bp-items{grid-template-columns:minmax(0,1.15fr) minmax(0,1fr);align-items:start;grid-auto-rows:min-content;}';
$css.=$root.'[data-wtx-feature-count="1"]>.wtx-bp-items>.wtx-news-card--feature{grid-row:1 / span var(--wtx-feature-rows,1);height:auto;align-self:start;}';
$css.=$row.'{height:auto;align-self:start;}'.$row.'>.wtx-news-card-copy{flex:initial;padding:0;}';
$css.=$row.' .wtx-news-card-meta{margin-block-start:8px;padding-block-start:0;}';
$css.=$row.' .wtx-news-deck{'.(!empty($p['secondary_excerpt'])?'display:-webkit-box;-webkit-box-orient:vertical;-webkit-line-clamp:2;overflow:hidden;font-size:14px;line-height:1.65;margin:6px 0;':'display:none;').'}';
$css.=$lead.' .wtx-news-title{font-size:var(--wtx-section-title,24px)!important;}';
$css.='@media(max-width:'.(int)$settings['tokens']['tablet'].'px){'.$root.'[data-wtx-feature-count="1"]>.wtx-bp-items{grid-template-columns:minmax(0,1fr);}'.$lead.','.$row.'{grid-column:auto;grid-row:auto;}}';
}
}
return $css;
}
/** Local initials are derived only from the same resolved byline if its image cannot load. */
function wtx143_avatar_guard($html,$identity,$options) {
$name=wtx143_plain_text($identity['name']??'');preg_match('/[\p{L}\p{N}]/u',$name,$m);
return $html.(($options['fallback']??'initials')!=='none'&&isset($m[0])?''.esc_html($m[0]).'':'');
}
.wtxs-menu-overlay.wtx150-fullscreen .wtxs-overlay-panel{width:100%;max-width:100%;min-height:100dvh;margin:0;}
.wtxs-menu-overlay .wtx150-secondary-title{font-size:1rem;margin-block:20px 6px;}