ckanext disqus

Extensión Disqus

La extensión Disqus permite a los visitantes del sitio comentar paquetes individuales utilizando un sistema de comentarios basado en AJAX. Las desventajas de este complemento son que los comentarios no se almacenan localmente y la información del usuario no se comparte entre CKAN y el sistema de comentarios.

Nota: esta extensión requiere ckan 1.7 o superior

Activando e instalando

Para configurar el complemento Disqus, primero debe ir a disqus.com y configurar un foro con su nombre de dominio. Podrás elegir un nombre para el foro.

Para instalar el complemento, ingrese su entorno virtual y cargue la fuente:

 (pyenv)$ pip instalar -e git+https://github.com/okfn/ckanext-disqus#egg=ckanext-disqus

Para versiones de ckan anteriores a 2.0, utilice la rama release-v1.8.

Esto también registrará un punto de entrada del complemento, por lo que ahora debería poder agregar lo siguiente a su archivo CKAN .ini:

 ckan.plugins = disqus <otros-complementos>
disqus.name = TU_DISQUS_NAME

En este punto, cada página de vista del conjunto de datos tendrá comentarios de Disqus. Para agregar comentarios en otras páginas, consulte la siguiente sección.

Disqus utilizará window.location.href como disqus_url. A veces es útil, especialmente durante el desarrollo, especificar la URL base para que disqus la utilice. Esto se puede agregar al archivo CKAN .ini:

 disqus.disqus_url = my_staging.server.com

No incluya 'http://' ni una barra diagonal.

Usando la extensión

Comentarios Hilos

Para que aparezcan hilos de comentarios en las páginas, insértelos en las plantillas donde desea que aparezcan los comentarios:

 {{h.disqus_comments()}}

Nota para los desarrolladores de temas: la extensión intenta generar un disqus_identifier del formulario:

 {controlador/nombre-objeto-de-dominio}::{id}

Donde controlador = 'grupo' en la sección de grupo, 'conjunto de datos' en la sección del conjunto de datos (tenga en cuenta que esto difiere del nombre del controlador internamente, que sigue siendo paquete), 'recurso' para recursos, etc. Este identificador será útil si lo desea. haga referencia a este comentario (por ejemplo, para el recuento de comentarios) en otra parte del sitio.

Comentarios recientes

Insertar en las páginas donde desea que aparezcan comentarios recientes:

 {{h.disqus_recent()}}

El widget de comentarios recientes mostrará 5 comentarios recientes de forma predeterminada. Para mostrar 10 comentarios recientes utilice lo siguiente:

 {{h.disqus_recent(num_comments=10)}}

Otros widgets

Disqus ofrece muchos otros widgets. En lugar de proporcionarlos automáticamente como parte de esta extensión, sugerimos que los desarrolladores de temas incorporen el código directamente (tenga en cuenta que puede acceder a las variables de configuración relevantes desde el objeto de configuración pasado a todas las plantillas).

Inicio de sesión único

Disqus ofrece una opción de "Inicio de sesión único" que permite a los usuarios enviar comentarios utilizando el nombre de usuario/contraseña local en lugar de requerir una cuenta de Disqus separada. Para obtener instrucciones sobre cómo configurar las cosas en el extremo de Disqus (es decir, crear claves API), consulte: https://help.disqus.com/customer/portal/articles/236206-integrating-single-sign-on

Para integrarse con este complemento de CKAN, debe almacenar sus claves pública y secreta en el archivo ini de CKAN:

 ckan.plugins = disqus <otros-complementos>
disqus.name = TU_DISQUS_NAME
disqus.secret_key = TU_DISQUS_SECRET_KEY
disqus.public_key = TU_DISQUS_PUBLIC_KEY