Ana içeriğe geç

iframe olarak göm

Oylama Panonuzu iframe kodu kullanarak doğrudan ürününüze gömmek. Kullanıcılar uygulamanızdan ayrılmadan panoya erişebilir.

Aşağıdaki örnek, bir sayfaya gömülmüş ve çerçevede açılan bir Ducalis Oylama Panosu gösteriyor.

Panoyu gömmek​

  1. Oylama Panosunu seçin ve yayınlandığını doğrulayın.

  2. Voting settings (Oylama ayarları) → Embed (Göm) → Embed The Whole Board (Tüm Panoyu Göm) bölümüne gidin.

  3. Widget Base Code'u kopyalayın.

  4. Widget koduna embedBoard nesnesini ekleyin (gömme için gereklidir).

Son kodunuz şöyle görünmelidir:

dclsPxl("initWidget", {
    // Required
    appId: "dc9ae89*******",
    boardId: "78aef2c7c0********",

    user: {
        // Required
        email: "Your user Email",
        hash: "User hash",

        // Optional
        userID: "Your user ID",
        name: "Your user Name",
        avatar: "https://you-user-avatar-domain/avatar.png",
        company: {
            id: 123,
            name: "Your user Company name",
            customFields: {
                created_at: "2019-06-02 17:10:00",
                spend: 123000,
                mrr: 100,
                plan: "pro",
                prop: value,
            }
        }
    },

    // Required for Voting Board embedding
    embedBoard: {
        selector: "#selector-where-show-iframe", // CSS selector where to render Voting Board
        style: undefined, // Optional, iframe styles object, e.g. "style: {position: 'absolute', top: 0}"
    },
});

Varsayılan sayfayı ayarlamak​

Kullanıcılar widget'ı yüklediklerinde Roadmap veya Changelog sayfasının önce açılıp açılmayacağını seçin.

Kodda defaultView parametresini yapılandırın. roadmap veya changelog olarak ayarlayın:

dclsPxl("initWidget", {
    // Optional, default is undefined
    // Use 'roadmap' or 'changelog' to open specific page
    defaultView: undefined,
});

Changelog ve Roadmap sayfaları için, isteğe bağlı olarak belirli bir filtre veya eylem açabilirsiniz (yalnızca yetkili kullanıcılar için):

dclsPxl("initWidget", {
    // Optional
    // Use to open a specific filter (only for authorized users)
    openNewIdea: true,
    myIdeas: true,
    myVotes: true,
});

Bildirim balonu eklemek​

Kullanıcıları yeni güncellemeler ve sürümler hakkında uyarmak için bildirim rozetleri gösterin.

Widget koduna bubble nesnesini ekleyin:

dclsPxl("initWidget", {
    bubble: {
        // Optional, default is ".Ducalis-changelog-widget"
        // Use for bubble without widget
        selector: '#embedBoardBuble',

        // Optional, default is undefined
        // Clears initial styles. Use for custom styles by className ONLY.
        className: 'some-class-name',

        // Optional, default is undefined
        // Customizes initial styles.
        style: {
            right: '7px',
            top: '7px',
            backgroundColor: '#db3737',
            borderRadius: '4px',
            fontSize: '13px',
        }
    },
});

Arka planı özelleştirmek​

Şeffaf bir arka plan ekleyerek panoyu arayüzünüze ve markanıza uyarlayın:

embedBoard: {
    // Optional, default is false
    // Makes iframe and board background transparent
    transparent: true,
}

Özel CSS sınıfı eklemek​

Yalnızca gelişmiş kullanım için

Varsayılan stiller olmadan bildirim balonuna özel bir sınıf adı ekleyin. Bildirim balonunu kendi CSS'nizle özelleştirebilirsiniz.

Sınıfınızı belirtmek için bubble.className kullanın:

bubble: {
    // Optional, clears initial styles
    // Use for custom styles by className ONLY. Default is undefined
    className: 'some-class-name',
}
Kullanımdan kaldırılan parametre

bubbleClassName parametresi hala çalışıyor ancak kullanımdan kaldırılacak. Bunun yerine bubble.className kullanın.

Sürüm notlarına otomatik abonelik​

Sürüm notlarına otomatik abonelik varsayılan olarak etkindir. Bu, yeni aktif kullanıcıları sürekli içe aktarma ihtiyacını önler.

Kullanıcılar şu durumlarda otomatik olarak abone olur:

  1. Widget aracılığıyla kullanıcı verilerini Ducalis uygulamasına gönderirsiniz (user.email ve user.hash gereklidir).
  2. Kullanıcı widget'ı veya pano çerçevesini açar.
Özel e-posta alan adı ayarlayın

Abone olan kullanıcılara sürüm notları göndermek için özel bir e-posta alan adı ayarlayın.

Last updated: Yesterday