Integrate CelebrationApp Pro with your custom code using our JavaScript API.
Global Object
All functionality is available through the global window.celebrationAppPro object.
// Check if CelebrationApp Pro is loaded
if (window.celebrationAppPro) {
console.log('CelebrationApp Pro is ready!');
}
Core Methods
celebrationAppPro.trigger()
Manually trigger a celebration.
// Basic celebration
celebrationAppPro.trigger();
// Celebration with options
celebrationAppPro.trigger({
template: 'gaming',
intensity: 80,
message: 'Custom success message!',
position: 'top-center'
});
celebrationAppPro.updateSettings()
Update app settings programmatically.
celebrationAppPro.updateSettings({
enabled: true,
currentTemplate: 'luxury',
intensity: 75,
audioEnabled: true
});
celebrationAppPro.getSettings()
Retrieve current settings.
const settings = celebrationAppPro.getSettings();
console.log('Current template:', settings.currentTemplate);
console.log('Intensity:', settings.intensity);
Event Listeners
Listen for celebration events in your code:
// Listen for celebration start
document.addEventListener('celebration:start', function(event) {
console.log('Celebration started:', event.detail);
// Your custom code here
});
// Listen for celebration end
document.addEventListener('celebration:end', function(event) {
console.log('Celebration ended:', event.detail);
// Analytics tracking, etc.
});
// Listen for A/B test assignment
document.addEventListener('celebration:ab-test', function(event) {
console.log('A/B test variant:', event.detail.variant);
});
Custom Events
Trigger celebrations on custom events:
// Trigger on custom button click
document.getElementById('special-offer').addEventListener('click', function() {
celebrationAppPro.trigger({
template: 'luxury',
message: 'Special offer claimed! 🏆'
});
});
// Trigger on form submission
document.getElementById('newsletter-form').addEventListener('submit', function() {
celebrationAppPro.trigger({
template: 'classic',
message: 'Thanks for subscribing! 📧'
});
});