Complementos Premium de PokerTracker 4 (para desarrolladores)

Resumen

Premium Add-Ons está disponible en PokerTracker 4.10 y versiones posteriores. Te permiten crear personalizaciones, como HUD Profiles, Statistics y Reports, protegidas para impedir que los usuarios modifiquen o compartan tu Add-On con otras personas. Un Premium Add-On se instala automáticamente en el cliente registrado de PokerTracker 4 del usuario. Cualquier cambio que guardes se publica de inmediato y cada usuario lo recibe la próxima vez que inicia PokerTracker 4.

Solo los desarrolladores de complementos prémium preaprobados pueden acceder a las herramientas necesarias para publicar y proteger un complemento prémium. La dirección de PokerTracker se reserva el derecho de decidir qué desarrolladores son aceptados en el Programa de Desarrolladores de Complementos Prémium o eliminados de él.

Cómo funciona

1. Solicita permiso para convertirte en desarrollador de Complementos Premium.
2. Crea el contenido personalizado que quieras vender o compartir con la comunidad de PokerTracker 4.
3. Sube el contenido al panel del desarrollador como complemento prémium.
4. Define los permisos predeterminados que recibe cada cliente del complemento y establece los niveles de grupos de niveles que quieres poder asignar.
5. Agrupa varios complementos en un paquete si quieres distribuirlos como un único producto.
6. Da acceso a los clientes, ya sea uno a uno o asignando un grupo de clientes.
7. Asigna un grupo de niveles y anula los permisos para los clientes que necesiten algo distinto.
8. Cuando el cliente reinicia PokerTracker 4, el complemento se descarga e instala automáticamente con los permisos que hayas configurado.

Contenido disponible para protección

El menú desplegable Addon Type ofrece los siguientes tipos de contenido:

• HUD
• Reports
• Stats
• Replayer Themes

Product ofrece actualmente solo PokerTracker 4.

Cómo aplicar

Para solicitar ser desarrollador de PokerTracker Premium Add-On, envía un correo a merchants@pokertracker.com con el asunto “PokerTracker 4 Premium Add-On Developer Application”. En el correo, incluye la siguiente información:

1. Su cuenta de usuario registrada en PokerTracker.com.
2. Si solicitas como particular o como empresa, con una dirección postal y un número de teléfono. Incluye el nombre de la empresa si solicitas como empresa.
3. La URL de su sitio web donde ofrecerá los PokerTracker Premium Add-Ons.
4. Una breve descripción de ti o de la empresa.
5. Una breve descripción del tipo de premium add-ons que vas a proporcionar.

PokerTracker suele responder en un plazo de dos días laborables.

Conceptos clave

El panel del desarrollador se compone de cuatro objetos — complementos, paquetes, clientes y grupos de clientes — y los permisos y los grupos de stakes son los ajustes que les aplicas. Cada tarea en esta página es una operación sobre uno de ellos.

Permisos

Los permisos son conmutadores de funciones de activado/desactivado que expone el tipo de un complemento; por ejemplo, si un cliente puede añadir o eliminar estadísticas en uno de tus informes. Cada tipo tiene su propia lista, así que las casillas que ves dependen del Addon Type y del Product que hayas elegido. HUD expone 15 permisos, Reports expone 6 y Replayer Themes expone 1.

Hasta que se seleccionen un tipo y un producto, el formulario muestra “Select an addon type and product to load available permissions.” en lugar de una cuadrícula vacía.

Grupos de niveles

Un grupo de stakes es un límite máximo e inclusivo de stakes. Cada uno contiene un único valor por tipo de juego:

Campo	Significado	Ejemplo de entrada
Ciegas NL y PL	Ciega máxima de no limit o pot limit	0.25
Ciegas Limit	Ciega máxima de fixed-limit	0.50
Buy-in máximo de Tourn./SNG	Buy-in máximo de torneo o SNG	22.00

Define tantos grupos de stakes como necesites y trátalos como niveles. A cada cliente se le asigna un nivel, o ninguno.

Los niveles se identifican por sus valores y no por un nombre que tú elijas. El ejemplo anterior aparece en los menús desplegables de clientes como 0.25 NL, 0.50 FL & 22.00 buyin. Los valores se normalizan a dos decimales al guardarlos, así que 5 se almacena como 5.00.

Paquetes

Un paquete agrupa varios complementos. Cuando se añade un cliente a un paquete, recibe automáticamente acceso a todos los complementos que contiene, lo que te permite distribuir una colección de complementos como un solo producto.

Un paquete define sus propios permisos y grupos de stakes, un conjunto para cada tipo de complemento que contiene. Esos ajustes sustituyen a los de los complementos miembros, que no aportan nada salvo su contenido; por tanto, un cliente cuyo acceso procede del paquete sigue las restricciones del paquete, no las del complemento. Consulta Packages.

Clientes y grupos de clientes

Un cliente es una licencia de PokerTracker 4, identificada por la dirección de correo electrónico y el código de registro con los que se registró. Un grupo de clientes es una colección con nombre de clientes: asigna el grupo a un add-on o a un paquete y todos sus miembros obtendrán acceso al mismo tiempo.

Un cliente tiene un acceso por complemento, y ese acceso registra de dónde procede: de ti, de un paquete o de un grupo.

Creación de un premium add-on

nota

El panel de desarrollador solo está disponible para cuentas aprobadas para el programa PokerTracker Premium Add-On. Consulta Cómo solicitarlo.

1. Inicia sesión en el panel de desarrollador de PokerTracker con tu cuenta de PokerTracker.
2. En la barra lateral izquierda, selecciona Premium Addons > Manage Addons.
3. Haz clic en NEW ADDON.
4. Elige el Addon Type y Product, y después introduce un Addon Name.
5. Introduce una Trial Length (Days) si quieres que los nuevos clientes empiecen con una prueba limitada por tiempo.
6. En Upload Your Files, selecciona el archivo del complemento.
7. En Permissions, marca las funciones que cada cliente de este complemento obtiene de forma predeterminada.
8. En Stake Groups, haz clic en ADD STAKE GROUP e introduce los niveles que quieras poder asignar más adelante.
9. Haz clic en CREATE ADDON.

El campo de carga indica el límite de tamaño y las extensiones que acepta el tipo que has elegido:

Tipo de addon	Tamaño máximo	Extensiones
HUD	20 MB	.cfg, .pt4hud
Informes	20 MB	.pt4rpt
Temas del Replayer	25 MB	.zip, .pt4theme

Algunos tipos también solicitan imágenes en Addon Images — una Screenshot y una Thumbnail, además de un HUD Logo para los complementos HUD. Aportálas cuando el formulario las muestre, porque guardar sin ellas falla con “Please upload required files: Screenshot, Thumbnail”.

Tu complemento prémium ya se ha subido a la tienda y está listo para compartirse. El siguiente paso es dar acceso a tus clientes.

Modificación de un add-on existente

1. Inicia sesión en el panel de desarrollador de PokerTracker y selecciona Premium Addons > Manage Addons.
2. Localiza el complemento que quieres modificar.
3. Haz clic en EDIT en su fila.
4. Realiza los cambios.
5. Haz clic en SAVE CHANGES.

Cada fila ofrece los mismos tres botones: CUSTOMERS abre la lista de clientes del complemento, EDIT abre el complemento para editarlo y DELETE lo elimina. La columna Customers usa la notación 0 (P: 5), donde el primer número cuenta los clientes que has añadido directamente al complemento y el número entre paréntesis cuenta a los que acceden a él a través de un paquete.

Cualquier cambio guardado se publica de inmediato, y todos los clientes que hayas asignado al complemento lo recibirán la próxima vez que inicien PokerTracker 4.

aviso

Si un cliente tiene permiso para modificar o personalizar tu addon, cualquier cambio que haya realizado se eliminará cuando actualices el addon. Planifícalo en consecuencia para que la pérdida de estos cambios no afecte a tus clientes.

Configuración de los valores predeterminados del add-on

Los permisos y los grupos de stakes se configuran en la página de edición del complemento, accesible desde Manage Addons > EDIT, pero funcionan de forma distinta. Los permisos son valores predeterminados reales: todos los clientes del complemento los siguen salvo que anules un permiso para ese cliente. Los grupos de stakes son un menú de niveles que defines aquí para poder asignarlos más adelante; definir uno no restringe a nadie hasta que lo selecciones para un cliente o un grupo.

Permisos predeterminados

Marca los permisos que debe recibir cada cliente y, después, haz clic en SAVE CHANGES.

Solo se guardan respecto a un cliente las diferencias con estos valores predeterminados. Así, cuando cambias un valor predeterminado más adelante, todos los clientes reciben el cambio en los permisos que no hayan anulado, mientras que sus propias modificaciones no se tocan. Para dar a un cliente algo distinto, consulta Anular permisos.

Definición de grupos de niveles

1. Desplázate hasta Stake Groups en la página de edición del add-on.
2. Haz clic en ADD STAKE GROUP para añadir una fila numerada.
3. Introduce los valores de NL & PL Stakes, Limit Stakes y Max Tourn./SNG Buyin.
4. Repite el proceso para cada nivel que quieras ofrecer.
5. Haz clic en SAVE CHANGES.

Deja un campo en blanco para que ese tipo de juego siga sin restricciones por el nivel. Una fila completamente en blanco no se guarda. Cuando no hay grupos de ciegas definidos, la sección muestra «No stake groups configured».

Cambio de los valores de un grupo de niveles

Edita los valores directamente y después haz clic en SAVE CHANGES. Todos los clientes ya asignados a ese grupo de ciegas siguen los nuevos valores al instante; un cliente se asigna al propio grupo de ciegas y no a una copia de sus valores, así que no hay nada que reasignar.

Eliminación de un grupo de niveles

Haz clic en REMOVE en la fila del grupo de ciegas y, después, en SAVE CHANGES. No hay mensaje de confirmación, y la fila solo se elimina al guardar; hasta entonces, CANCEL descarta la eliminación junto con cualquier otra edición no guardada.

aviso

Eliminar un grupo de stake también lo quita de todos los clientes asignados a él. Esos clientes vuelven a -- No Stake Restrictions --, lo que elimina por completo su límite de stake, así que asígnalos a otro nivel si no es lo que quieres.

Paquetes

Los paquetes se encuentran en Premium Addons > Addon Packages, y NEW PACKAGE crea uno. Un paquete incluye un Package Name y su propio Trial Length (Days), exactamente igual que un addon.

Restricciones de paquete

aviso

Un paquete usa solo sus propios permisos y grupos de ciegas. Los ajustes de los addons miembros se ignoran mientras el acceso de un cliente proceda del paquete, así que configura las restricciones en el propio paquete.

Package Restrictions muestra una sección por cada tipo de addon del paquete, cada una con su propia tabla de Permissions y sus filas de Stake Groups. Un paquete que contenga un addon de Reports y un addon de HUD tiene, por tanto, dos secciones que rellenar, y cada una funciona exactamente igual que los valores predeterminados del addon de arriba.

Añadir o quitar addons miembros

1. Abre el paquete y desplázate hasta Package Addons.
2. Elige un add-on en el menú desplegable y, a continuación, haz clic en ASSIGN.
3. Haz clic en UNASSIGN en una fila para quitar ese addon del paquete.
4. Haz clic en SAVE CHANGES.

Al quitar el último addon de un tipo determinado, se eliminan las restricciones de ese tipo al guardar.

Gestión de clientes

Un cliente llega a tu addon de una de estas tres formas:

• Lo añadiste directamente al addon.
• Pertenece a un grupo de clientes asignado al addon.
• Tiene acceso a un paquete que incluye el addon.

Para ver los clientes de un addon, ve a Manage Addons y haz clic en CUSTOMERS en la fila del addon.

La columna Source indica de dónde procede cada acceso. Las filas procedentes de un paquete o de un grupo de clientes muestran allí una insignia y un - en Actions, porque sus permisos y su grupo de ciegas se gestionan en el paquete o en el grupo, no en el cliente individual. Las filas que añadiste directamente al addon no muestran insignia y sí ofrecen acciones por fila.

Encima de la tabla, el panel CUSTOMER GROUPS muestra los grupos asignados a este addon. Consulta Grupos de clientes.

Añadir un cliente

1. Haz clic en ADD CUSTOMER en la lista de clientes del addon para conceder acceso a ese addon, o ve a Premium Addons > Customers > ADD CUSTOMER para crear un cliente sin concederle todavía ningún acceso.
2. Selecciona el Product e introduce el Email del cliente.
3. Introduce los seis últimos caracteres del Código de registro del cliente.
4. Marca los Customer Groups a los que deba unirse el cliente.
5. Haz clic en ADD CUSTOMER.

La dirección de correo electrónico y el código de registro deben ser los con los que el cliente registró PokerTracker 4. Ambos se encuentran en PokerTracker 4 en Help > About. El formulario solo necesita los seis últimos caracteres del código de registro, no el código completo. Si Help > About no muestra estos valores, pídele al cliente que actualice a la última versión de PokerTracker 4 antes de continuar.

El código se valida contra el sistema de licencias mientras se crea el cliente. Si la pareja no coincide con una licencia, el formulario muestra «No license found for the provided email and registration code.» y no se crea ningún cliente.

Al seleccionar grupos en este formulario, se aprovisiona automáticamente el acceso al addon del grupo. Si no seleccionas ninguno, después puedes añadir el cliente a un grupo o concederle acceso al addon.

Editar un cliente

Abre la lista de clientes del addon o del paquete, localiza al cliente y haz clic en la acción de edición de su fila.

CUSTOMER SUMMARY muestra la dirección de correo electrónico, las fechas de acceso y el código de registro. CUSTOMER SETTINGS contiene Access Type y Expiration Date. Debajo de eso, cada tipo de addon aporta un desplegable de Stake Group y una tabla de Permission Overrides. Haz clic en SAVE CHANGES cuando termines; volverás a la lista de clientes de la que venías.

Anular permisos

En Permission Overrides, activa o desactiva las funciones que quieras cambiar para este cliente y después haz clic en SAVE CHANGES. Los permisos resaltados son los que difieren del valor predeterminado del addon o del paquete; en la imagen de arriba, Add/remove report filters? se ha activado solo para este cliente.

Una anulación se aplica solo a este cliente y no afecta al resto de clientes del addon o del paquete. Solo se guardan los permisos que cambias realmente, así que el resto siguen el valor predeterminado y se actualizan con él.

Configurar un grupo de ciegas

A diferencia de los permisos, un grupo de ciegas nunca se aplica automáticamente. Un acceso nuevo empieza en -- No Stake Restrictions -- sin nada seleccionado, haya los niveles que haya definidos en el addon o en el paquete, así que el cliente juega a cualquier nivel hasta que le asignes uno.

En Stake Group, selecciona uno de los niveles definidos en el addon o en el paquete y después haz clic en SAVE CHANGES. Selecciona -- No Stake Restrictions -- para quitar de nuevo la restricción. Un paquete te ofrece un desplegable por cada tipo de addon, y un tipo sin grupos de ciegas definidos muestra «No stake groups assigned». Al volver a abrir el acceso más adelante se muestra el nivel guardado.

Buscar un cliente en todos los addons

Premium Addons > Customers abre la vista global de addons. Busca por dirección de correo electrónico o código de registro, filtra por producto o acota la lista a clientes con acceso activo y luego haz clic en FILTER. CLEAR restablece los filtros.

Haz clic en el + junto a una fila para mostrar los accesos individuales de ese cliente, una fila por producto. Un Kind de — en la fila de nivel superior significa que los accesos del cliente están mezclados entre productos en lugar de ser todos del mismo tipo, así que despliega la fila para ver cuáles tiene. El acceso de pago muestra un valor de Expires de Never, mientras que una prueba muestra una fecha.

Cada nivel tiene sus propias acciones. En una fila de nivel superior, el engranaje verde abre la página de detalles del cliente y la X roja elimina al cliente por completo. En una fila de acceso desplegada, el lápiz verde edita solo ese acceso y la X roja elimina solo ese acceso.

La página de detalles del cliente reúne toda la información sobre un cliente en cuatro paneles:

• CUSTOMER INFORMATION — la dirección de correo electrónico, el código de registro y el número de addons. DELETE CUSTOMER elimina al cliente y todo su acceso.
• CUSTOMER GROUPS — los grupos a los que pertenece este cliente, con ADD TO GROUP para añadirlo a otro.
• PRODUCT ACCESS — todos los accesos que tiene el cliente.
• ADD TO ADDON — todos los addons y paquetes que ofreces, cada uno con un botón ADD ACCESS.

Grupos de clientes

Los grupos de clientes te permiten organizar a los clientes en colecciones con nombre. Asigna un grupo a un addon o a un paquete para conceder acceso a todos sus miembros a la vez. Los grupos se encuentran en Premium Addons > Customer Groups, y NEW CUSTOMER GROUP crea uno. Un grupo incluye un Group Name y una Description opcional, y MANAGE MEMBERS añade y quita clientes.

Asignar un grupo

Hay dos formas de conseguir el mismo resultado:

• En la lista de clientes del addon o del paquete, elige el grupo en el panel CUSTOMER GROUPS y haz clic en ASSIGN.
• En Customer Groups > EDIT, elige el destino en el panel ASSIGNED ADDONS y haz clic en ASSIGN. Este desplegable incluye tanto paquetes como addons individuales.

Los miembros reciben inmediatamente el acceso del grupo, y cualquier persona que añadas al grupo más adelante también lo recibe.

Permisos de grupo y grupos de stakes

Las restricciones de un grupo se configuran por add-on o paquete, en la página Settings del grupo y no en el grupo en sí. Editar un grupo en Customer Groups solo cambia su nombre, descripción y membresía; nunca aplica restricciones. Asignar un único add-on concede el acceso al instante y sin tener que rellenar ningún formulario, así que abre Settings después si ese grupo necesita algo distinto de los valores predeterminados del add-on.

Al guardar estos ajustes, se vuelven a aplicar a todos los accesos activos procedentes de grupo para ese add-on, tanto a los miembros que ya tienen acceso como a cualquiera que se añada al grupo más adelante. Borrar los ajustes deja a esos miembros de nuevo con los valores predeterminados del add-on. Los ajustes del grupo se superponen a esos valores predeterminados en lugar de sustituirlos, así que cualquier permiso que el grupo no haya cambiado sigue el valor predeterminado del add-on y cambia cuando tú lo cambias.

Los accesos que has concedido de forma individual, los accesos que proceden de otro grupo y los accesos que has convertido a acceso individual se omiten todos y se notifican como tales. Por tanto, guardar los ajustes del grupo no puede sobrescribir a nadie que hayas configurado deliberadamente a mano.

Un miembro cuyo acceso procede de un grupo no tiene controles individuales de permisos ni de stake, porque esos ajustes pertenecen al grupo. Para darle a un miembro algo distinto, usa Convert to Individual Access. Esto convierte un único acceso, no al cliente: sigue en el grupo, sus permisos actuales y su grupo de stakes se conservan como punto de partida y pasan a ser editables, y los cambios posteriores del grupo ya no afectan a ese acceso. Además, se mantiene tras un UNASSIGN posterior, que solo revoca el acceso que siga procediendo del grupo. Un miembro de un grupo asignado a tres add-ons necesita una conversión por cada add-on.

Desasignar un grupo

Haz clic en UNASSIGN en la fila del grupo. Se revoca el acceso que procedía de ese grupo. Quitar a un solo miembro del grupo revoca el acceso de ese miembro procedente del grupo del mismo modo y deja intactos al resto.

Qué ajuste prevalece

Origen	Se aplica a
Valores predeterminados del add-on o paquete	Todos los clientes de ese add-on o paquete
Ajustes del grupo de clientes	Accesos activos procedentes de grupo para ese add-on, superpuestos a los valores predeterminados
Ajustes individuales del cliente	Un acceso, superpuesto a los valores predeterminados

Un cliente tiene un acceso por add-on, así que exactamente una de las dos últimas filas lo gobierna, nunca ambas. Convert to Individual Access es lo que mueve un acceso de la segunda fila a la tercera.

Las dos filas inferiores solo almacenan sus diferencias respecto a los valores predeterminados, así que la fila superior nunca se omite: todo lo que un grupo o un cliente no haya cambiado específicamente sigue el valor predeterminado del add-on o paquete, y cambia cuando tú lo cambias.

Un paquete utiliza sus propios permisos y grupos de stakes, no los de los add-ons que contiene, así que configura las restricciones en el propio paquete. Los clientes cuyo acceso procede de un paquete se gestionan desde la lista de clientes de ese paquete: en la lista de clientes de un add-on, su columna Source nombra el paquete y su celda Actions muestra -.

Pruebas y acceso

Trial Length (Days) en un add-on o un paquete establece por defecto cuánto dura una nueva prueba. El acceso de cada cliente lleva entonces un Access Type de TRIAL o PAID junto con una Expiration Date.

Convertir un cliente de prueba a pago

Dos controles convierten un cliente de prueba en un cliente de pago:

• En la página de detalles del cliente, a la que se accede desde Premium Addons > Customers haciendo clic en el engranaje verde de su fila, haz clic en SWITCH TO PAID en el acceso que quieras convertir.
• En la página de edición del acceso, establece Access Type en PAID y haz clic en SAVE CHANGES.

El acceso de pago muestra Expires: Never salvo que establezcas una fecha de expiración.

Establecer una fecha de expiración

Abre el acceso del cliente para editarlo e introduce una nueva Expiration Date. El campo sustituye la fecha directamente en lugar de añadirle días, así que para ampliar una prueba una semana, introduce una fecha una semana posterior a la que ya figura. Deja el campo en blanco para volver a la duración de prueba del add-on, como indica su texto de ayuda: “Defaults to trial length if blank”.

Eliminar acceso

Eliminar acceso impide que un cliente use un add-on que le habías concedido previamente.

Hay dos controles para eliminar acceso, con distinto alcance:

• Remove en una sola fila de acceso elimina ese acceso y deja intactos los demás accesos del cliente. El navegador te pedirá confirmación.
• Remove All, la X roja de una fila de nivel superior en la lista de clientes entre add-ons, elimina el registro del cliente junto con todos los accesos que tenga.

Ninguno de los dos controles elimina el acceso que procede de un grupo de clientes. Saca al cliente del grupo o desasigna el grupo del add-on.

Estadísticas personalizadas premium y columnas personalizadas

Todas las estadísticas personalizadas o columnas personalizadas que incluyas deben tener nombres únicos que no corran el riesgo de entrar en conflicto con columnas personalizadas de terceros o nombres de estadísticas personalizadas creados por la comunidad de usuarios o por otros desarrolladores de Premium Add-On.

Añade un prefijo al nombre de todas las columnas y estadísticas personalizadas para reducir la posibilidad de que haya nombres en conflicto. Por ejemplo, si el nombre de tu producto Premium Add-On es LASVEGASHUD y el producto contiene estadísticas y columnas personalizadas, el prefijo de cada nombre de estadística o columna personalizada podría ser lvh_. Esta norma de desarrollo tiene el efecto adicional de facilitar la localización de todas las estadísticas o columnas personalizadas asociadas a tu Premium Add-On.

Preguntas frecuentes

¿Por qué no aparece nada en Permissions o Stake Groups?

O bien todavía no se ha seleccionado ningún Addon Type ni Product, o bien la combinación que has seleccionado no ofrece opciones de ese tipo. En ambos casos, el formulario lo indica en lugar de mostrar una cuadrícula vacía.

¿Tengo que reasignar a los clientes después de cambiar los valores de un grupo de stakes?

No. Todos los clientes asignados a ese grupo de stakes siguen sus nuevos valores.

¿Qué significa “No Stake Restrictions”?

No se aplica ningún límite de stakes para ese tipo de add-on, así que el cliente puede usar el add-on en cualquier stake.

¿Por qué una fila de cliente no tiene botón EDIT ni DELETE?

Su acceso procede de un paquete o de un grupo de clientes, indicado en la columna Source. Gestiónalo en el paquete o en el grupo, o abre el cliente desde Premium Addons > Customers.

¿Por qué falló al añadir un cliente con “No license found”?

La dirección de correo electrónico y el código de registro no coinciden con ninguna licencia. Comprueba ambos en PokerTracker 4 Help > About e introduce solo los seis últimos caracteres del código de registro.