SDK Reference

const result = await sdk.content.getPosts({
  filter: { category: 'news' },
  page: 1,
  limit: 10,
  sort: 'createdAt',
  order: 'desc'
});
 
// Returns:
{
  items: [...],    // Array of posts
  total: 100,      // Total count
  page: 1,         // Current page
  pages: 10        // Total pages
}

const post = await sdk.content.getPost('my-post-slug');
const post = await sdk.content.getPost('507f1f77bcf86cd799439011');

const latest = await sdk.content.getLatestPosts(10);

const featured = await sdk.content.getFeaturedPosts(6);

const results = await sdk.content.searchPosts('search term', { 
  limit: 20 
});

const categories = await sdk.content.getCategories();

const category = await sdk.content.getCategory('news');

const authors = await sdk.content.getAuthors();

const author = await sdk.content.getAuthor('john-doe');

const tags = await sdk.content.getTags({ limit: 50 });

const url = sdk.media.getImageUrl(post.featuredImageData, 'md');
 
// Sizes: 'xs', 'sm', 'md', 'lg', 'xl'

const srcset = sdk.media.getSrcSet(imageData, ['sm', 'md', 'lg']);
// Returns: "image-sm.jpg 640w, image-md.jpg 1024w, image-lg.jpg 1920w"

const html = sdk.media.getPictureElement(imageData, {
  sizes: '(max-width: 640px) 100vw, 50vw',
  alt: 'Image description',
  className: 'my-image',
  loading: 'lazy'
});

if (sdk.media.hasImage(post.featuredImageData)) {
  // Has image
}

sdk.hooks.addAction('post.viewed', async (post) => {
  console.log('Post viewed:', post.title);
}, 10); // priority (lower = earlier)

sdk.hooks.addFilter('post.title', (title) => {
  return title.toUpperCase();
}, 10);

sdk.hooks.removeAction('post.viewed', myCallback);

sdk.hooks.removeFilter('post.title', myCallback);

// Simple shortcode: [greeting name="John"]
sdk.shortcodes.register('greeting', (attrs, content) => {
  return `<div>Hello, ${attrs.name}!</div>`;
});
 
// With content: [box type="info"]Content here[/box]
sdk.shortcodes.register('box', (attrs, content) => {
  return `<div class="box box-${attrs.type}">${content}</div>`;
});

if (sdk.shortcodes.exists('greeting')) {
  // Shortcode is registered
}

const all = sdk.shortcodes.getAll();

sdk.widgets.registerWidget('my-widget', {
  name: 'My Widget',
  description: 'Widget description',
  icon: '🎯',
  
  settings: [
    { key: 'title', type: 'text', label: 'Title', default: 'My Widget' },
    { key: 'count', type: 'number', label: 'Count', default: 5 },
    { key: 'showImages', type: 'boolean', label: 'Show Images', default: true },
    { 
      key: 'style', 
      type: 'select', 
      label: 'Style',
      options: [
        { value: 'default', label: 'Default' },
        { value: 'compact', label: 'Compact' }
      ],
      default: 'default'
    }
  ],
  
  render: async (settings, sdk) => {
    return `
      <div class="my-widget">
        <h3>${settings.title}</h3>
        <!-- Widget content -->
      </div>
    `;
  }
});

sdk.widgets.registerArea('sidebar', {
  name: 'Sidebar',
  description: 'Main sidebar widgets',
  beforeWidget: '<div class="widget">',
  afterWidget: '</div>',
  beforeTitle: '<h3 class="widget-title">',
  afterTitle: '</h3>'
});

const html = await sdk.widgets.renderArea('sidebar');

if (sdk.widgets.isAreaActive('sidebar')) {
  // Has widgets
}

sdk.admin.addMenuItem({
  id: 'my-plugin',
  title: 'My Plugin',
  icon: '<svg>...</svg>',
  position: 50,
  capability: 'admin',
  render: async (req, res) => {
    return '<div>My admin page</div>';
  }
});

sdk.admin.addSubMenuItem('my-plugin', {
  id: 'settings',
  title: 'Settings',
  render: async (req, res) => {
    return '<div>Settings page</div>';
  }
});

sdk.admin.addDashboardWidget({
  id: 'my-stats',
  title: 'My Statistics',
  position: 'side', // 'normal' or 'side'
  render: async () => '<div>Stats content</div>'
});

sdk.admin.registerSettingsSection({
  id: 'my-settings',
  title: 'My Plugin Settings',
  tab: 'plugins',
  fields: [
    { key: 'apiKey', type: 'text', label: 'API Key' },
    { key: 'enabled', type: 'toggle', label: 'Enable', default: false }
  ]
});

// GET endpoint
sdk.rest.registerRoute('my-plugin/v1', '/items', {
  methods: ['GET'],
  permission: 'public', // 'public', 'authenticated', 'admin'
  args: {
    page: { type: 'integer', default: 1 },
    limit: { type: 'integer', default: 10 }
  },
  callback: async (req) => {
    return { items: [], total: 0 };
  }
});
 
// POST endpoint
sdk.rest.registerRoute('my-plugin/v1', '/items', {
  methods: ['POST'],
  permission: 'authenticated',
  callback: async (req) => {
    const { title } = req.body;
    // Create item...
    return { success: true, id: '123' };
  }
});

await sdk.storage.set('myData', { count: 42, items: [] });

const data = await sdk.storage.get('myData');

await sdk.storage.delete('myData');

sdk.utils.formatDate(new Date(), 'default'); // "January 12, 2026"
sdk.utils.formatDate(new Date(), 'short');   // "Jan 12, 2026"
sdk.utils.formatDate(new Date(), 'iso');     // "2026-01-12T..."

sdk.utils.slugify('Hello World!'); // "hello-world"

sdk.utils.truncate('Long text here...', 100); // "Long text..."

sdk.utils.stripHtml('<p>Hello</p>'); // "Hello"

sdk.utils.escapeHtml('<script>'); // "&lt;script&gt;"

sdk.utils.randomId();     // "x7k2m9p4"
sdk.utils.randomId(16);   // Longer ID

const html = sdk.ui.pagination({
  currentPage: 1,
  totalPages: 10,
  baseUrl: '/posts',
  maxVisible: 5
});

const html = sdk.ui.breadcrumb([
  { label: 'Home', url: '/' },
  { label: 'Posts', url: '/posts' },
  { label: 'Current Post' }
]);

const html = sdk.ui.menu('primary');

const html = sdk.ui.shareButtons({
  url: 'https://example.com/post',
  title: 'Post Title',
  platforms: ['facebook', 'twitter', 'pinterest', 'email']
});