delete($wpdb->options,['option_name'=>$name,'option_value'=>$old]);wp_cache_delete($name,'options');
}
if(!add_option($name,$value,'','no')) {return $this->err('busy','Another save is running. Please retry in a moment.',409);}
}
// Permissions can prime the meta cache before another request finishes a save.
// Read the current revision from storage only after this request owns the lock.
wp_cache_delete($id,'post_meta');
try { return $run(); }
finally { $wpdb->delete($wpdb->options,['option_name'=>$name,'option_value'=>$value]);wp_cache_delete($name,'options'); }
}
public function save_document($r) {
$id=$this->request_id($r);$doc=Document::clean($r->get_param('doc'));if(is_wp_error($doc)){return $doc;}
return $this->locked($id,function()use($id,$r,$doc){
$old=$this->envelope($id);
if(!hash_equals($old['revision'],(string)$r->get_param('revision'))){return $this->err('conflict','This document changed in another editor. Export your work, then reload before saving.',409);}
$canonicalOld=Document::clean($old['doc']??[]);
if(!is_wp_error($canonicalOld)&&wp_json_encode($doc)===wp_json_encode($canonicalOld)&&wp_json_encode($old['doc'])===wp_json_encode($canonicalOld)){return $this->response($this->payload($id));}
if(!$this->remember($id,$old)){return $this->err('history_storage','The previous version could not be stored safely. The draft was not changed. Check database storage and retry.',500);}
$new=['revision'=>wp_generate_uuid4(),'doc'=>$doc];
if(!update_post_meta($id,'_digibl_draft',wp_slash(wp_json_encode($new)))){return $this->err('storage','The draft could not be saved. Your changes remain in the editor.',500);}
update_post_meta($id,'_digibl_saved_at',gmdate('Y-m-d H:i:s'));
update_post_meta($id,'_digibl_saved_by',get_current_user_id());
return $this->response($this->payload($id));
});
}
/** History is independent of WP revisions, and never includes transient local edits. */
private function remember(int $id,array $env): bool {
$raw=get_post_meta($id,'_digibl_history',true);
$history=$raw!==''?json_decode((string)$raw,true):[];
if(!is_array($history)){return false;}
$history=array_values(array_filter($history,static fn($v)=>is_array($v)&&($v['revision']??'')!==($env['revision']??'')));
$date=(string)get_post_meta($id,'_digibl_saved_at',true);
$author=(int)get_post_meta($id,'_digibl_saved_by',true);
array_unshift($history,['date'=>$date?str_replace(' ','T',$date).'Z':gmdate('c'),'user'=>$author?: (int)get_post_field('post_author',$id),'revision'=>$env['revision'],'doc'=>$env['doc'],'kind'=>'history']);
$history=array_slice($history,0,20);
while(strlen((string)wp_json_encode($history))>3000000&&count($history)>1){array_pop($history);}
$json=wp_json_encode($history);
return is_string($json)&&($json===$raw||update_post_meta($id,'_digibl_history',wp_slash($json))!==false);
}
public function history($r) {
$id=$this->request_id($r);$raw=get_post_meta($id,'_digibl_history',true);
$history=$raw!==''?json_decode((string)$raw,true):[];
if(!is_array($history)){return $this->err('history_data','Saved history is unreadable. Existing data has been preserved; contact the site administrator.',500);}
$env=$this->envelope($id);$list=[];
if(isset($env['doc'],$env['revision'])){
$date=(string)get_post_meta($id,'_digibl_saved_at',true);
$list[]=['date'=>$date?str_replace(' ','T',$date).'Z':'','user'=>(int)get_post_meta($id,'_digibl_saved_by',true),'revision'=>$env['revision'],'doc'=>$env['doc'],'kind'=>'current','current'=>true];
}
$published=json_decode((string)get_post_meta($id,'_digibl_published',true),true);
if(is_array($published)){
$list[]=['date'=>(string)get_post_meta($id,'_digibl_published_at',true),'user'=>(int)get_post_meta($id,'_digibl_published_by',true),'revision'=>(string)get_post_meta($id,'_digibl_published_revision',true),'doc'=>$published,'kind'=>'published','current'=>false];
}
foreach(array_slice($history,0,20) as $v){if(is_array($v)&&isset($v['doc'],$v['revision'])){$v['kind']='history';$v['current']=false;$list[]=$v;}}
$out=[];
foreach($list as $entry){
$clean=Document::clean($entry['doc']);if(is_wp_error($clean)){continue;}
$user=!empty($entry['user'])?get_userdata((int)$entry['user']):false;
$out[]=['date'=>sanitize_text_field($entry['date']??''),'user'=>(int)($entry['user']??0),'author'=>$user?sanitize_text_field($user->display_name):'',
'revision'=>sanitize_text_field($entry['revision']),'doc'=>$clean,'kind'=>$entry['kind'],'current'=>!empty($entry['current'])];
}
return $this->response($out);
}
public function publish_document($r) {
$id=$this->request_id($r);$p=get_post($id);$obj=get_post_type_object($p->post_type);
if(!current_user_can($obj->cap->publish_posts)){return $this->err('publish','You do not have permission to publish this content.',403);}
return $this->locked($id,function()use($id,$r,$p){
$p=get_post($id);$env=$this->envelope($id);
if(!is_string($r->get_param('sourceRevision'))||!hash_equals($this->source_revision($id),(string)$r->get_param('sourceRevision'))){return $this->err('conflict','The original page changed outside this editor. Reopen it before publishing.',409);}
if(!hash_equals($env['revision'],(string)$r->get_param('revision'))){return $this->err('conflict','The saved draft changed. Reload before publishing.',409);}
$doc=Document::clean($env['doc']);if(is_wp_error($doc)){return $doc;}
// 1.2.9: template slot markers are editorial recommendations only.
// WordPress may publish an untitled or intentionally sparse page; do not block it here.
$publish=function()use($id,$p,$env,$doc){
$previous=get_post_meta($id,'_digibl_published',true);
// Set revisioned meta before wp_update_post, so WordPress revisions capture it together.
$json=wp_json_encode($doc);if($previous!==$json && !update_post_meta($id,'_digibl_published',wp_slash($json))){return $this->err('storage','The publication could not be saved.',500);}
$status='private'===$p->post_status?'private':'publish';
$saved=wp_update_post(wp_slash(['ID'=>$id,'post_status'=>$status,'post_title'=>$doc['title'],'post_excerpt'=>$doc['excerpt'],'post_content'=>(new Renderer(false,$id,true))->render($doc)]),true);
if(is_wp_error($saved)){if($previous){update_post_meta($id,'_digibl_published',wp_slash($previous));}else{delete_post_meta($id,'_digibl_published');}return $saved;}
$view_area=get_post_type($id)==='digibl_template'?(string)get_post_meta($id,'_digibl_pending_view_area',true):'';
if($view_area){$assigned=ThemeBuilder::assign_view_template($view_area,$id);if(is_wp_error($assigned)){$restored=wp_update_post(wp_slash(['ID'=>$id,'post_status'=>$p->post_status,'post_title'=>$p->post_title,'post_excerpt'=>$p->post_excerpt,'post_content'=>$p->post_content]),true);if($previous){update_post_meta($id,'_digibl_published',wp_slash($previous));}else{delete_post_meta($id,'_digibl_published');}if(is_wp_error($restored)||get_post_meta($id,'_digibl_published',true)!==$previous){return $this->err('rollback','Publication failed and restoration could not be completed. Contact support before retrying.',500);}return $assigned;}}
update_post_meta($id,'_digibl_published_revision',$env['revision']);
update_post_meta($id,'_digibl_published_at',gmdate('c'));
update_post_meta($id,'_digibl_published_by',get_current_user_id());
foreach(['_digibl_creation_session','_digibl_adoption_session','_digibl_adoption_source_revision'] as $key){delete_post_meta($id,$key);}
clean_post_cache($id);
do_action('digibl_document_published',$id,$doc);
do_action('digiter_builder_content_changed',$id,'digiter-builder-lite');
return $this->response($this->payload($id));
};
return $p->post_type==='digibl_template'&&get_post_meta($id,'_digibl_pending_view_area',true)?ThemeBuilder::with_settings_lock($publish):$publish();
});
}
public function preview($r) {
$context=$r->get_param('contextId')??0;
if(!is_int($context)||$context<0){return $this->err('preview_context','Invalid preview context.');}
if($context&&(!get_post($context)||!current_user_can('edit_post',$context))){return $this->err('preview_context','You cannot preview this content.',403);}
$doc=Document::clean($r->get_param('doc'));if(is_wp_error($doc)){return $doc;}
$payload=['html'=>(new Renderer(true,$context))->render($doc)];
if($r->get_param('validateDocument')===true){$payload['doc']=$doc;}
// Explicit card commits reuse the same allowlist as page save. No new permissions.
if($r->get_param('validateCard')===true&&count($doc['nodes'])===1){$payload['node']=$doc['nodes'][0];}
return $this->response($payload);
}
public function saved_templates() {return $this->response(get_user_meta(get_current_user_id(),'_digibl_templates',true)?:[]);}
public function analyze_design($r) {
$source=$r->get_param('html');
$candidate=null!==$source?(new DesignImporter())->analyze($source):DesignImporter::from_url($r->get_param('url'));
if(is_wp_error($candidate)){return $candidate;}
$candidate['targetId']=$this->request_id($r);
$candidate['html']=(new Renderer(true))->render($candidate['doc']);
return $this->response($candidate);
}
public function save_template($r) {
$doc=Document::clean($r->get_param('doc'));if(is_wp_error($doc)){return $doc;}
$name=Document::text($r->get_param('name'),100);if(!$name){return $this->err('name','Give this template a name.');}
$templates=get_user_meta(get_current_user_id(),'_digibl_templates',true)?:[];
array_unshift($templates,['id'=>wp_generate_uuid4(),'name'=>$name,'doc'=>$doc,'date'=>gmdate('c')]);$templates=array_slice($templates,0,20);
update_user_meta(get_current_user_id(),'_digibl_templates',wp_slash($templates));return $this->response($templates);
}
public function conditional_cache(): void {
if(!is_singular(PostTypes::all())){return;}
$doc=json_decode(get_post_meta(get_queried_object_id(),'_digibl_published',true),true);if(!is_array($doc)){return;}
$sensitive=is_user_logged_in();$scan=function($nodes)use(&$scan,&$sensitive){foreach($nodes as $n){$s=$n['style']??[];if(($s['audience']??'all')!=='all'||!empty($s['start'])||!empty($s['end'])||!empty($s['visibility'])||in_array($n['type'],['component','reusable','woo-pages','loop','mega-menu','data-repeater','builder-template','integration'],true)){$sensitive=true;}$scan($n['children']??[]);}};$scan($doc['nodes']??[]);
if($sensitive){if(!defined('DONOTCACHEPAGE')){define('DONOTCACHEPAGE',true);}nocache_headers();}
}
public function front_assets(): void {
if(!is_singular(PostTypes::all()) || (!$this->frame_id && !$this->private_preview() && !get_post_meta(get_queried_object_id(),'_digibl_published',true))){return;}
Assets::styles((bool)($this->frame_id || $this->private_preview()));
// An editor frame may receive any module after the initial page load.
if($this->frame_id || $this->private_preview()){Assets::full();Modules::preview_assets();}
}
public function content($content) {
if($this->frame_id && get_the_ID()===$this->frame_id && in_the_loop() && is_main_query()){
$doc=Document::clean($this->envelope($this->frame_id)['doc']??$this->source_document($this->frame_id));
return is_wp_error($doc)?$content:''.(new Renderer(true))->render($doc).'
';
}
if(is_admin() || !is_singular(PostTypes::all()) || !in_the_loop() || !is_main_query() || post_password_required()){return $content;}
if($this->private_preview()){
$doc=Document::clean($this->envelope(get_the_ID())['doc']??[]);
return is_wp_error($doc)?$content:(new Renderer())->render($doc);
}
$json=get_post_meta(get_the_ID(),'_digibl_published',true);if(!$json){return $content;}
$doc=Document::clean(json_decode($json,true));if(is_wp_error($doc)){Assets::enqueue_html($content);return PageCSS::stylesheet($content,(int)get_the_ID()).$content;}return (new Renderer())->render($doc);
}
public function template($template) {
if(!is_singular(PostTypes::all())){return $template;}
$doc=($this->frame_id||$this->private_preview())?($this->envelope(get_queried_object_id())['doc']??[]):json_decode(get_post_meta(get_queried_object_id(),'_digibl_published',true),true);
if($this->frame_id && isset($_GET['digibl_canvas'])){$doc['settings']['canvas']=is_string($_GET['digibl_canvas']) && $_GET['digibl_canvas']==='1';}
return !empty($doc['settings']['canvas'])?DIGIBL_PATH.'templates/canvas.php':$template;
}
private function private_preview(): bool {
return is_preview() && $this->owned(get_queried_object_id()) && current_user_can('edit_post',get_queried_object_id());
}
public function row_actions($actions,$post) {
if(($this->owned($post->ID)||$this->can_prepare($post->ID)) && current_user_can('edit_post',$post->ID)){$actions['dbs']='Digiter Builder';}
return $actions;
}
public function meta_box(): void {
foreach(PostTypes::all() as $type){add_meta_box('dbs-open','Digiter Builder',function($post){
if($this->owned($post->ID)||$this->can_prepare($post->ID)){echo ''.esc_html__('Open this page with the front-end editor.','digiter-builder-lite').'
Open Digiter Builder';}
else{echo ''.esc_html__('This content is controlled by another builder and is not converted automatically.','digiter-builder-lite').'
Open Studio';}
},$type,'side');}
}
public function admin_bar($bar): void {
if(!PostTypes::can_edit()){return;}
$id=get_queried_object_id();$singular=!is_admin() && is_singular(PostTypes::all()) && current_user_can('edit_post',$id);
$bar->add_node(['id'=>'dbs-edit','title'=>'Digiter Builder','href'=>$singular?$this->builder_url($id):$this->studio_url()]);
// Template selection belongs to the Studio sidebar, not an automatic landing screen.
}
}