';
}
/**
* Adds an icon which has explanatory text when hovered over.
* @param string $explanation
* @param string $extra_css_classes
* @param string $url not escaped
* @return string HTML
*/
function pmb_hover_tip( $explanation = '', $extra_css_classes = '', $url = '' ) {
$html = '';
if ( $url ) {
$html .= '';
}
$html .= '';
if ( $url ) {
$html .= '';
}
return $html;
}
/**
* Returns a string that says this feature only works with Pro Print Service (not supported by browsers).
* @return string
*/
function pmb_pro_print_service_only( $explanation = '' ) {
$upgrade_url = pmb_fs()->get_upgrade_url();
$hover_text = '' . __( 'Purchase Required', 'print-my-blog' ) . '';
if ( $explanation ) {
$hover_text .= '
' . $explanation;
}
return pmb_hover_tip( $hover_text, 'pmb-pro-only', $upgrade_url );
}
/**
* Echoes out that this feature only works with pro print service (not supported by browsers)
* @param string $explanation
*/
function pmb_pro_print_service_only_e( $explanation = '' ) {
// phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- outputting HTML
echo pmb_pro_print_service_only( $explanation );
}
/**
* Returns a string that says this feature works best with Print My Blog Pro.
* @return string
*/
function pmb_pro_print_service_best( $explanation = '' ) {
$upgrade_url = pmb_fs()->get_upgrade_url();
$hover_text = '' . sprintf(
// translators: 1: opening anchor tag, 2: closing anchor tag.
__( 'Works better with %1$sPro PDF Service%2$s', 'print-my-blog' ),
'',
''
) . '';
if ( $explanation ) {
$hover_text .= '
' . $explanation;
}
return pmb_hover_tip( $hover_text, 'pmb-pro-best', $upgrade_url );
}
/**
* Echoes out this feature works best with pro print service.
* @param string $explanation
*/
function pmb_pro_print_service_best_e( $explanation = '' ) {
// phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- outputting HTML
echo pmb_pro_print_service_best( $explanation );
}
/**
* Echoes out that there's a better feature in Pro Print
* @param string $explanation
*/
function pmb_pro_better_e( $explanation = '' ) {
// phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- outputting HTML
echo pmb_pro_better( $explanation );
}
/**
* To tell folks about features of Pro Print not available for Quick print
* @param string $explanation
* @return string
*/
function pmb_pro_better( $explanation = '' ) {
$url = admin_url( PMB_ADMIN_PROJECTS_PAGE_PATH );
$hover_text = '' . sprintf(
// translators: 1: opening anchor tag, 2: closing anchor tag.
__( 'More Advanced Features in %1$sPro Print%2$s', 'print-my-blog' ),
'',
''
) . '';
if ( $explanation ) {
$hover_text .= '
' . $explanation;
}
return pmb_hover_tip( $hover_text, '', $url );
}
/**
* Maps
* @param \PrintMyBlog\orm\entities\ProjectSection $section
*
* @return string
*/
function pmb_map_section_to_division( ProjectSection $section ) {
if ( $section->getPlacement() === DesignTemplate::IMPLIED_DIVISION_FRONT_MATTER ) {
return 'front_matter_article';
}
if ( $section->getPlacement() === DesignTemplate::IMPLIED_DIVISION_BACK_MATTER ) {
return 'back_matter_article';
}
return apply_filters( 'pmb_map_section_to_division', pmb_map_section_height_to_division( $section->getHeight() ), $section );
}
/**
* @param int $height
* @return string
*/
function pmb_map_section_height_to_division( $height ) {
switch ( $height ) {
case 1:
$division_name = 'part';
break;
case 2:
$division_name = 'volume';
break;
case 3:
$division_name = 'anthology';
break;
case 0:
default:
$division_name = 'article';
}
return $division_name;
}
/**
* Renders a PMB template in the template directory
* @param string $template_name
* @param array $context
*/
function pmb_render_template( $template_name, $context = [] ) {
// phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- outputting HTML
echo pmb_get_contents( PMB_TEMPLATES_DIR . $template_name, $context );
}
/**
* Renders any file
* @param $filename
* @param array $context
*/
function pmb_get_contents( $filename, $context = [] ) {
// phpcs:ignore WordPress.PHP.DontExtract.extract_extract -- we're making them available while rendering the template file.
extract( $context );
ob_start();
require $filename;
return ob_get_clean();
}
/**
* @param \PrintMyBlog\orm\entities\Design $design
*/
function pmb_design_preview( \PrintMyBlog\orm\entities\Design $design ) {
// phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- outputting HTML
pmb_render_template( 'partials/design_preview.php', [
'design' => $design,
] );
}
/**
* Gets a post item div HTML for the sortable.js sorting area.
* @param ProjectSection|WP_Post $posty_row
* @param Project $project
* @param int $max_nesting
*/
function pmb_content_item( $posty_row, Project $project, $max_nesting = null ) {
if ( $posty_row instanceof \PrintMyBlog\orm\entities\ProjectSection ) {
$id = $posty_row->getPostId();
$title = $posty_row->getPostTitle();
$post_type = get_post_type_object( get_post_type( $posty_row->getPostId() ) );
$template = $posty_row->getTemplate();
$height = $posty_row->getHeight();
$subs = $posty_row->getCachedSubsections();
$depth = $posty_row->getDepth();
} else {
$id = $posty_row->ID;
$title = $posty_row->post_title;
$post_type = get_post_type_object( $posty_row->post_type );
$template = null;
$height = 0;
$subs = [];
$depth = 1;
}
$edit_url = get_edit_post_link( $id );
$view_url = get_permalink( $id );
$duplicate_url = wp_nonce_url( add_query_arg( [
'action' => Admin::SLUG_ACTION_DUPLICATE_PRINT_MATERIAL,
'ID' => $id,
], admin_url( PMB_ADMIN_PROJECTS_PAGE_PATH ) ), Admin::SLUG_ACTION_DUPLICATE_PRINT_MATERIAL );
// if the post type is no longer registered, the plugin that added it probably got removed, so hide this item.
if ( !$post_type ) {
return;
}
if ( $max_nesting === null ) {
$max_nesting = $project->getLevelsAllowed();
}
?>
1,
], site_url( '/' ) );
}
function pmb_get_filename( $url, $remove_extension = false ) {
$filename_and_extension = basename( $url );
if ( $remove_extension ) {
$filename_and_extension = substr( $filename_and_extension, 0, strpos( $filename_and_extension, '.' ) );
}
return $filename_and_extension;
}
/**
* Returns whether or not to use PMB Central for generate requests. (We like to use DocRaptor's server on free sites
* to keep the load down on printmy.blog; but for paying customers we like to monitor their API requests for quality assurance.)
* @return int
*/
function pmb_use_pmb_central() {
$use_pmb_central = 0;
try {
if ( pmb_fs()->is_plan__premium_only( 'business' ) || defined( 'PMB_USE_CENTRAL' ) && PMB_USE_CENTRAL ) {
$use_pmb_central = 1;
}
} catch ( Freemius_Exception $e ) {
// ignore it
}
return $use_pmb_central;
}