Reventa de extensiones

Cómo revender extensiones

Este método es aplicable en el caso de que desee vender instancias de Plesk junto con algunas extensiones comerciales. Asimismo, este le permite hacer upselling de las extensiones en su tienda online para las instancias de Plesk ya aprovisionadas. Tenga en cuenta que este método no cubre el caso de compras a través de la aplicación. En otras palabras, si sus clientes hacen clic en el botón "Comprar" presente en el catálogo de extensiones de Plesk, se les redireccionará a la tienda de Plesk, no a la suya.

Detalles de la implementación
  1. Es imprescindible que en su tienda online tenga como artículos Plesk y las extensiones que desea revender.
  2. Cuando se inicia una compra, debe contactar con KA mediante su API para partners y solicitar licencias para los artículos comprados.
  3. KA creará las licencias solicitadas y le enviará un único código de activación para dichas licencias. Tenga en cuenta que KA cuenta con dos versiones de la API para partners: v1 y v3.
    1. a. v1:
      1. https://central.plesk.com/docs/partner-api/1.0/
      2. Con una única llamada puede solicitar la clave principal de Plesk y múltiples claves adicionales para extensiones. Para más información, visite https://central.plesk.com/docs/partner-api/1.0/41090.htm.
      3. Una única clave de activación para la licencia principal de Plesk y sus claves de licencia adicionales.
      4. Se considera obsoleta, por lo que le recomendamos usar la versión v3.
    2. b. v3:
      1. https://central.plesk.com/docs/partner-api/3.0/
      2. Con una única llamada sólo puede solicitarse una clave (principal o adicional). Para más información, visite https://central.plesk.com/docs/partner-api/3.0/63401.htm.
      3. Una única clave de activación para la licencia principal de Plesk y sus claves de licencia adicionales. Las licencias adicionales solicitadas en distintas llamadas a la API se añaden a la licencia principal y la misma clave de activación para las licencias principales de Plesk sirve para activar más licencias.
      4. Se trata de la versión más reciente de la API para partners, por lo que se recomienda usar esta versión.
  4. Una vez su tienda reciba el código de activación, puede dárselo al cliente mediante el IU de la tienda online o por correo electrónico, o puede activar las licencias ejecutando un comando CLI en el interfaz de Plesk que ha creado para el cliente.

    La activación de licencias mediante CLI se efectúa ejecutando el comando “license”. Encontrará más información en https://docs.plesk.com/en-US/17.0/cli-linux/using-command-line-utilities/license-license-keys.71029/.

Soporte la upsell a través de la aplicación

El método anterior no cubre el caso de compras a través de la aplicación. En otras palabras, si sus clientes hacen clic en el botón "Comprar" presente en el catálogo de extensiones de Plesk, se les redireccionará a la tienda de Plesk, no a la suya. Con el fin de solucionar esta limitación hemos añadido la habilidad para indicar el nombre de host de su tienda en el archivo panel.ini. Una vez indicado, todos los enlaces "Comprar” y todos los demás enlaces de upsell presentes en las extensiones redireccionarán a su tienda online.

Para modificar la URL de la tienda online usada por los enlaces "Comprar", edite el archivo panel.ini y añada la siguiente línea a la sección  [extensions] :

[extensions]

buyUrl = "https://shop.com"

Aquí, "shop.com" es el nombre de dominio de su tienda online.

Un ejemplo de cómo funcionaría sería el siguiente:

  • URL original usada por una extensión:

https://go.plesk.com/buy-plesk-ext/extension-name?kn=PLESK.1234567890.0001

  • URL modificada usada por una extensión una vez especificado el nombre de host de su tienda online en panel.ini:

https://shop.com/?extension-id=extension-name&kn=PLESK.1234567890.0001

Nota: esta prestación sólo afectará a aquellas extensiones vendidas a través de Plesk y que usen “go.plesk.com” como nombre de host de destino. Si una extensión se vende directamente a través de una ISV, los enlaces "Comprar" y los demás enlaces de upsell no se verán afectados.

Cómo controlar las extensiones que desea mostrar y vender

Una vez modificada la URL de los enlaces "Comprar" tal y como se ha explicado anteriormente, todas las extensiones comerciales - incluyendo las que en un futuro se añadan al catálogo de extensiones - redireccionarán a su tienda, aún y cuando no las haya configurado todavía. Para garantizar que sus clientes sólo verán las extensiones comerciales que está preparado para vender, configure un servidor proxy inteligente para el catálogo de extensiones de Plesk. Este servidor proxy capturará el feed del catálogo de extensiones, filtrará las extensiones que no está preparado para vender y proporcionará el feed modificado a sus instancias de Plesk.

Detalles de la implementación

  1. Configure un servidor (físico o virtual) donde se ejecutará el script proxy.
  2. Obtenga el script proxy en https://github.com/plesk/extensions-catalog-proxy y sitúelo en el servidor. Este enlace contiene las instrucciones necesarias para entender cómo funciona el script proxy y cómo debería desplegarse.
  3. Configure el proxy para que sólo pasen aquellas extensiones comerciales que deberían ser visibles en sus servidores Plesk.

    El proxy funciona como una lista blanca – debe especificar los IDs de las extensiones comerciales que deberían mostrarse en Plesk, ya que todo lo demás no será visible. Encontrará la lista de extensiones y sus IDs (“códigos”) en https://ext.plesk.com/api/v4/packages

    Importante: el proxy sólo afecta a las extensiones que presenten enlaces "Comprar" que apunten a https://go.plesk.com. Las extensiones gratuitas y las extensiones que presenten enlaces "Comprar" que apunten a otro sitio seguirán siendo visibles en el catálogo de extensiones en sus servidores Plesk.

  4. Cambie la URL del feed del catálogo de extensiones en todos sus servidores Plesk para que así este apunte a la dirección del servidor proxy. Esta modificación puede llevarse a cabo añadiendo la siguiente línea a panel.ini:

    [extensions]

    catalog.url = http://<proxy-address>:8080

  5. Cuando en el catálogo de extensiones se añada una extensión comercial y usted haya configurado su tienda para vender esta extensión, modifique el proxy añadiendo el ID de la extensión correspondiente para que así dicha extensión esté disponible para sus clientes. Tenga en cuenta que el feed del catálogo se copia en caché en los servidores Plesk y que las extensiones nuevas no se mostrarán de inmediato.

A continuación en esta sección:

Venta de licencias de Plesk con licencias de extensiones

Upsell de extensiones a través de la aplicación

 

Venta de licencias de Plesk con licencias de extensiones

Use este método si desea vender instancias de Plesk que incluyan determinadas extensiones de pago. Este método no permite la compra desde la propia aplicación.

Detalles de la implementación

  1. Es imprescindible que en su tienda online tenga como artículos Plesk y las extensiones que desea revender.
  2. Cuando un cliente efectúe un pedido, deberá contactar con KA mediante el API de KA Partner y solicitar licencias para los artículos comprados.
  3. KA creará las licencias solicitadas y le enviará un único código de activación para las licencias. Tenga en cuenta que KA cuenta con dos versiones de la API para partners: v1 y v3.
    1. Partner API v1 (obsoleto, no recomendado):
      1. Puede solicitar tanto la clave principal de Plesk como múltiples claves adicionales para extensiones en una única llamada (vea createKey()).
      2. Usa un único código de activación tanto para la licencia principal de Plesk como para todas las llaves de licencia adicionales.
    2. Partner API v3 (recomendado):
      1. Únicamente puede solicitar una clave (ya sea la clave principal de Plesk o bien otra clave para una extensión ) en una única llamada (vea Creación de una llave de licencia).
      2. Usa un único código de activación tanto para la licencia principal de Plesk como para todas las llaves de licencia adicionales. Las llaves adicionales solicitadas en otras llamadas a la API se añaden a la licencia principal.El código de activación de la licencia principal de Plesk también activará todas las llaves adicionales añadidas.
  4. Una vez su tienda reciba el código de activación, puede dárselo al cliente mediante el IU de la tienda online o por correo electrónico. Alternativamente (además de ser preferible), puede activar las licencias ejecutando un comando CLI en la instancia de Plesk creada para el cliente. Puede activar licencias mediante el CLI a través de la utilidad “license” (Plesk para Linux, Plesk para Windows).
 

Upsell de extensiones a través de la aplicación

Use este método si desea hacer upsell de extensiones en su tienda online para instancias de Plesk ya aprovisionadas. Cuando alguno de sus clientes haga clic en el botón "Comprar" presente en el catálogo de extensiones de Plesk, se le redireccionará a su tienda online para que pueda efectuar el pedido correspondiente.

Integración con KA
  1. Cuando un cliente efectúe un pedido, deberá contactar con KA mediante el API de KA Partner y solicitar una licencia para la extensión comprada.Pase el número de llave principal de Plesk como argumento en la llamada a la API.
  2. KA creará la licencia de la extensión solicitada y la añadirá a la licencia principal de Plesk.
  3. Para solicitar las licencias, puede usar Partner API v1 o v3:
    1. Partner API v1 (obsoleto, no recomendado): cree la licencia de una extensión y añádala a la licencia principal de Plesk en una única llamada (vea createKey())
    2. Partner API v3 (recomendado): cree la licencia de una extensión y añádala a la licencia principal de Plesk en una única llamada (vea Creación de una llave de licencia)

Una vez solicitada la licencia de una extensión mediante el API para partners, esta se añade a la licencia principal de Plesk. La licencia de la extensión se instalará en el servidor Plesk la próxima vez que Plesk se conecte a KA para actualizar la licencia principal de Plesk. Generalmente esto suele tardar entre un día y un mes. Asimismo, el cliente también puede realizar los pasos detallados a continuación para instalar la licencia de la extensión de inmediato - en el interfaz de su tienda online, por ejemplo:

  1. En el panel de navegación a la izquierda, haga clic en Herramientas y configuración.
  2. Haga clic en Administración de licencias (debajo de Plesk).
  3. Haga clic en Recuperar llaves para instalar la nueva llave de licencia en Plesk.
Redireccionamiento de clientes a su tienda online

Por omisión, cuando un cliente hace clic en el botón "Comprar" en el catálogo de extensiones de Plesk, se le redirecciona a la tienda de Plesk, no a su tienda. Si desea modificar este comportamiento, especifique el nombre de host de su tienda en el archivo panel.ini. Una vez modificado el nombre de host de la tienda, todos los enlaces "Comprar” y los demás enlaces de upsell presentes en las extensiones redireccionarán a su tienda online.

Para modificar la URL de la tienda online vinculada a los enlaces "Comprar", edite el archivo panel.ini y añada la siguiente línea a la sección [extensions]:

[extensions]
buyUrl = "https://shop.com"

Aquí, "shop.com" es el nombre de dominio de su tienda online.

Un ejemplo de cómo funcionaría sería el siguiente:

  • La URL original usada por una extensión:

    https://go.plesk.com/buy-plesk-ext/some-extension-name?kn=PLESK.12345678.0001&token=U29NZVVuaXF1ZUdVSUQxMjM%3D&product-id=SomeProductID

    La URL modificada usada por una extensión una vez especificado el nombre de host de su tienda en el archivo panel.ini: https://shop.com/?extension-id=some-extension-name&kn=PLESK.12345678.0001&token=U29NZVVuaXF1ZUdVSUQxMjM%3D&product-id=SomeProductID

En el caso del modelo de licencia "Licencia única" o "Múltiples ofertas", el flujo de trabajo de la compra de la licencia sería el siguiente:

a

Ahora, cada vez que un cliente haga clic en el botón "Comprar", se le redireccionará a su tienda online. Compruebe que su tienda online puede gestionar los parámetros pasados en las URLs modificadas:

Nombre del parámetro Ejemplo Descripción

extension-id

extension-id=some-extension-name

El ID de la extensión. Aquí puede consultar la lista de extensiones y sus IDs (“codes”).

Seleccione la constante apropiada de Partner API para la extensión solicitada e inclúyala en la llamada a Partner API. La lista de constantes de Partner API está disponible en:

Tenga en cuenta que el “ID de la extensión" corresponde a extension-id en el caso de archivos de Excel y “extensionId” corresponde a extension-id en el caso de archivos JSON.

kn

kn=PLSK.12345678.0001

El número de llave principal de Plesk. Pase el número como número de llave secundaria en la llamada a la API.

token

token=U29NZVVuaXF1ZUdVSUQxMjM%3D

Parámetros opcionales. Únicamente necesario en el caso del modelo de licencias "Ofertas individuales”.

Con este modelo de licencias, los propietarios de un sitio web pueden contratar productos y servicios por sí mismos. Para ello, se añade un enlace al interfaz de usuario de Plesk que permite efectuar pedidos a los usuarios finales. En primer lugar, el usuario final selecciona el sitio web deseados, selecciona el producto escogido entre los productos ofrecidos por la extensión y finalmente va a la tienda online para finalizar el pedido.

El parámetro product-id especifica el ID del producto seleccionado por el cliente. Seleccione la constante apropiada de Partner API para la extensión y el producto escogido e inclúyala en la llamada a Partner API. Para encontrar la constante de Partner API apropiada mediante extension-id y product-id, use los siguientes enlaces:

Tenga en cuenta que el "ID de extensión" y el "ID de producto de extensión" corresponden a extension-id y product-id respectivamente en el caso de archivos de Excel y que “extensionId” y “extensionProductId” corresponden a extension-id y product-id respectivamente en el caso de archivos JSON.

El parámetro token es generado por la extensión e incluye el ID único del pedido. Este ID es imprescindible para que la extensión pueda controlar el estado del pedido a nivel de ISV. Este parámetro debe procesarse de la siguiente forma:

  1. En primer lugar, debe descifrarse conforme al mecanismo URL-encoding.
  2. A continuación, debe descifrarse conforme a la codificación BASE64.
  3. A continuación, debe pasarse a KA mediante una llamada a Partner API:

product-id

product-id=SomeProductID

En el caso del modelo de licencia "Ofertas individuales", el flujo de trabajo de la compra de la licencia sería el siguiente:

b

Nota: esta prestación sólo afectará a aquellas extensiones vendidas por Plesk que usen “go.plesk.com” como nombre de host de destino. Si una extensión se vende directamente a través de una ISV, los enlaces "Comprar" y los demás enlaces de upsell no se verán afectados.

Cómo controlar las extensiones que desea mostrar y vender

Una vez modificada la URL de los enlaces "Comprar" tal y como se ha explicado anteriormente, todas las extensiones comerciales - incluyendo las que en un futuro se añadan al catálogo de extensiones - redireccionarán a su tienda, aún y cuando no las haya configurado todavía. Para garantizar que sus clientes sólo verán las extensiones comerciales que está preparado para vender, configure un servidor proxy inteligente para el catálogo de extensiones de Plesk. Este servidor proxy capturará el feed del catálogo de extensiones, filtrará las extensiones que no está preparado para vender y proporcionará el feed modificado a sus instancias de Plesk.

Detalles de implementación:

  1. Configure un servidor (físico o virtual) donde se ejecutará el script proxy.
  2. Descargue el script proxy al servidor. Este enlace contiene las indicaciones necesarias para desplegar y operar con el script.
  3. Configure el proxy para que sólo pasen aquellas extensiones comerciales que deberían ser visibles en sus servidores Plesk. El proxy funciona como una lista blanca – debe especificar los IDs de las extensiones comerciales que deberían mostrarse en Plesk, ya que todo lo demás no será visible.

    Importante: el proxy sólo afecta a las extensiones cuyos enlaces "Comprar" apunten a https://go.plesk.com. El proxy no filtrará las extensiones gratuitas ni aquellas cuyos botones "Comprar" apunten a otra parte. Sea cual sea la configuración del proxy, estas se mostraran en el catálogo de extensiones de sus servidores Plesk.

  4. Cambie la URL del feed del catálogo de extensiones en todos sus servidores Plesk para que así apunte a la dirección del servidor proxy. Esto se lleva a cabo añadiendo la siguiente línea al archivo panel.ini:

    [extensions]

    catalog.url = http://<proxy-address>:8080

  5. Cuando en el catálogo de extensiones se añada una extensión comercial y usted haya configurado su tienda para vender esta extensión, modifique el proxy añadiendo el ID de la extensión correspondiente para que así dicha extensión esté disponible para sus clientes. Tenga en cuenta que el feed del catálogo se copia en caché en los servidores Plesk. Las extensiones nuevas no se mostrarán de inmediato.

La imagen que puede ver a continuación muestra cómo puede usarse el script proxy con el catálogo de extensiones:

new one

 

Leave your feedback on this topic here

If you have questions or need support, please visit the Plesk forum or contact your hosting provider.
The comments below are for feedback on the documentation only. No timely answers or help will be provided.