​

Controllers API Reference

This document provides comprehensive documentation for all controllers in the Yoneily system.

---

​

VideosController

Manages video content including file uploads, thumbnails, and video metadata. Location: app/controllers/videos_controller.php

​

Properties

• $name: ‘Videos’
• $helpers: [‘Html’, ‘Form’, ‘Javascript’]
• $uses: [‘Video’, ‘News’, ‘Archivo’, ‘Category’]
• $paginate: Limit 15, ordered by fechacre_videos DESC

​

Methods

​

index()

Lists all videos with pagination. Returns: Paginated list of videos

---

​

view($id)

Display details for a specific video.

---

​

add()

Create a new video with file uploads. Processes:

• Video file upload
• Thumbnail generation and resizing
• Image conversion using SimpleImage

---

​

edit($id)

Edit an existing video. ACL Check: Requires ‘editar videos’ permission

---

​

delete($id)

Delete a video by ID.

---

​

destacado($id)

Mark a video as featured (destacado = 1).

---

​

nodestacado($id)

Unmark a video as featured (destacado = 0).

---

​

VentasController

Handles sales transactions, shopping cart, and purchase management. Location: app/controllers/ventas_controller.php

​

Properties

• $name: ‘Ventas’
• $helpers: [‘Html’, ‘Form’, ‘Javascript’]
• $uses: [‘Venta’, ‘Locale’, ‘Gallery’, ‘Denuncia’, ‘Promo’, ‘Page’, ‘Codigo’]
• $paginate: Limit 10, ordered by fecha DESC

​

Public Methods (No Auth Required)

These methods are publicly accessible via beforeFilter():

• add, consulta, denunciar, finalizar_denunciar, add_promo, consulta_promocion, denunciar_promo, miscompras, mismensajes, misreclamos, finalizar_compra, pdf_compra, carrito, cuantos, pdf_completo_venta, add_carrito

​

Methods

​

index()

List all sales transactions with pagination.

---

​

add($producto,$usuario, $local,$cantidad, $cuantos)

Add a product sale transaction. Returns:

• 1 - Success
• 0 - Failed to save
• 2 - Product out of stock

---

​

add_carrito($producto,$usuario, $local,$cantidad, $cuantos)

Add item to shopping cart (same parameters as add()).

---

​

add_promo($producto,$usuario, $local,$cantidad, $cuantos)

Add a promotion sale.

---

​

consulta($producto,$usuario, $local)

Check product availability and purchase history. Returns:

• 3 - Product available
• 2 - Out of stock
• 4 - Already purchased

---

​

consulta_promocion($producto,$usuario, $local)

Check promotion availability (same parameters as consulta()).

---

​

finalizar_compra($forma_pago,$numero_pago, $id_venta)

Finalize a purchase with payment information.

---

​

miscompras()

View customer’s purchase history with pagination.

---

​

mismensajes()

View customer’s messages with pagination.

---

​

misreclamos()

View customer’s complaints/claims with pagination.

---

​

pdf_compra($id)

Generate PDF receipt for a specific purchase.

---

​

cuantos()

Get total count of sales. Returns: Integer count

---

​

UsersController

Manages user accounts, authentication, and permissions. Location: app/controllers/users_controller.php

​

Properties

• $name: ‘Users’
• $helpers: [‘Html’, ‘Form’, ‘Javascript’]
• $uses: [‘User’, ‘Group’, ‘Aco’, ‘Aro’, ‘ArosAco’, ‘Locale’]

​

Methods

​

index1()

List all users.

---

​

add()

Create a new user account.

---

​

add_vendedor()

Register a new vendor/seller with store association.

---

​

edit($id)

Edit user information.

---

​

edit_pass($id)

Change user password.

---

​

delete($id)

Delete a user account.

---

​

permission($id)

Manage user permissions via ACL. Returns: List of permissions with current access status

---

​

ajax_load()

AJAX handler for updating user permissions. POST Parameters:

• key: User ID
• key2: Permission alias
• key3: Current permission status (0 or 1)

---

​

login()

Display login page.

---

​

logout()

Log out current user and destroy session.

---

​

consulta_codigo($cod)

Check if a vendor code exists. Returns: Store ID if found, otherwise 0

---

​

RegistersController

Manages customer registration and profiles. Location: app/controllers/registers_controller.php

​

Properties

• $name: ‘Registers’
• $helpers: [‘Html’, ‘Form’, ‘Javascript’]
• $uses: [‘Estado’, ‘Ciudade’, ‘Paise’, ‘Register’, ‘Phone’, ‘Archivo’, ‘Venta’]

​

Public Methods

These methods are publicly accessible:

• loginequi, add, acceso, recordar, finregistro, verpais, loginfacebook, miperfil, actualizardatos, salir, add_cliente

​

Methods

​

index()

List all registered customers with pagination.

---

​

index_compras()

List all purchases with store filtering.

---

​

add($pais)

Register a new customer.

---

​

acceso()

Customer login via AJAX. POST Parameters:

• ema: Email address
• pass: Password

Returns: Session data if successful

---

​

loginfacebook($id)

Login via Facebook ID.

---

​

miperfil($id)

View and edit customer profile.

---

​

recordar()

Password recovery via email.

---

​

activa($id)

Activate a customer account.

---

​

desactiva($id)

Deactivate a customer account.

---

​

Finalizar_compra($id)

Finalize a purchase and update customer reputation. Updates: Increases customer’s puntuacion_positiva by 1

---

​

compra_falla($id)

Mark purchase as failed and update negative reputation. Updates: Increases customer’s puntuacion_negativa by 1

---

​

PromosController

Manages promotional offers and special deals. Location: app/controllers/promos_controller.php

​

Properties

• $name: ‘Promos’
• $helpers: [‘Html’, ‘Form’, ‘Javascript’]
• $uses: [‘Promo’, ‘Archivo’, ‘Category’, ‘Locale’]
• $paginate: Limit 10, ordered by fechacre_promo DESC

​

Methods

​

index()

List all promotions with store filtering.

---

​

add()

Create a new promotion. Processing:

• Resizes thumbnail to 450x280
• Creates slider image 779x280
• Sets cantidad_existente equal to cantidad
• Initializes prod_vendidos to 0

---

​

edit($id)

Edit an existing promotion.

---

​

delete($id)

Delete a promotion.

---

​

activa($id)

Activate/publish a promotion (publicar = 1).

---

​

desactiva($id)

Deactivate/unpublish a promotion (publicar = 0).

---

​

verlocal()

AJAX autocomplete for store search. GET Parameter:

• term: Search term

Returns: JSON array of stores matching search

---

​

PagesController

Handles public pages, contact forms, and customer inquiries. Location: app/controllers/pages_controller.php

​

Properties

• $name: ‘Pages’
• $helpers: [‘Html’, ‘Form’, ‘Javascript’]
• $uses: [‘Page’, ‘Aco’, ‘Aro’, ‘ArosAco’, ‘Video’, ‘Gallery’, ‘Phone’, ‘Promo’, ‘Estado’, ‘Ciudade’, ‘Register’, ‘User’, ‘Denuncia’, ‘Locale’]

​

Public Methods

These methods are publicly accessible:

• home, quienes, contactanos, mision, campanas, ofrendas, info, verestados, verciudad, detallepublicidad, detallegaleria, buscar, info_promo, registro_pregunta, registro_pregunta_galeria, info_galeria, detallelocales, delete_mensaje, promociones, productos

​

Methods

​

home()

Display homepage with random featured content. Returns:

• Random featured video
• 18 random stores
• 5 random promotions
• 2 random videos

---

​

buscar($f)

Search for stores, products, and promotions. Returns: Paginated results (8 items per page) for galleries and promotions

---

​

contactanos()

Contact form submission.

---

​

detallepublicidad($fecha,$url)

View promotion details.

---

​

detallegaleria($fecha,$url)

View product/gallery details.

---

​

detallelocales($rif,$frase)

View store details with products and promotions. Returns: Store information with paginated products and promotions (8 per page)

---

​

registro_pregunta()

Submit a question about a promotion.

---

​

registro_pregunta_galeria()

Submit a question about a product.

---

​

index_preguntas()

List unanswered questions with store filtering.

---

​

responder_pregunta($id)

View question details for responding.

---

​

registro_respuesta()

Submit a response to a customer question.

---

​

info_promo($producto,$usuario)

Display comments for a promotion.

---

​

info_galeria($producto,$usuario)

Display comments for a product.

---

​

existencia()

List products with available stock.

---

​

agotados()

List out-of-stock products.

---

​

promociones()

Browse all active promotions with pagination.

---

​

productos()

Browse all active products with pagination.

---

​

LocalesController

Manages stores/businesses in the system. Location: app/controllers/locales_controller.php

​

Properties

• $name: ‘Locales’
• $helpers: [‘Html’, ‘Form’, ‘Javascript’]
• $uses: [‘Locale’, ‘Archivo’, ‘Category’, ‘User’, ‘Group’, ‘Aco’, ‘Aro’, ‘ArosAco’]
• $paginate: Limit 10, ordered by status DESC

​

Public Methods

• acceso

​

Methods

​

index()

List all stores with pagination.

---

​

add()

Register a new store. Processing:

• Generates random 6-character code
• Resizes logo to 96x72 (thumbnail)
• Resizes logo to 600x480 (slider)
• Resizes location image to 600x480

---

​

edit($id)

Edit store information.

---

​

delete($id)

Delete a store.

---

​

activa($id)

Activate a store (status = 1).

---

​

desactiva($id)

Deactivate a store (status = 0).

---

​

pdf($id)

Generate PDF report for a store.

---

​

GroupsController

Manages user groups and group permissions. Location: app/controllers/groups_controller.php

​

Properties

• $name: ‘Groups’
• $helpers: [‘Html’, ‘Form’, ‘Javascript’]

​

Methods

​

index()

List all user groups.

---

​

add()

Create a new user group.

---

​

edit($id)

Edit a user group.

---

​

delete($id)

Delete a user group.

---

​

permission($id)

Manage group permissions via ACL. Returns: Permission tree with current access levels

---

​

ajax_load()

AJAX handler for updating group permissions. POST Parameters:

• key: Group ID
• key2: Permission alias
• key3: Permission status (0 or 1)

---

​

GalleriesController

Manages product galleries and images. Location: app/controllers/galleries_controller.php

​

Properties

• $name: ‘Galleries’
• $helpers: [‘Html’, ‘Form’, ‘Javascript’]
• $uses: [‘Gallery’, ‘Archivo’, ‘Category’, ‘Locale’]
• $paginate: Limit 10, ordered by fechacre_galeria DESC

​

Methods

​

index()

List all gallery items with store filtering.

---

​

add()

Create a new gallery item. Processing:

• Resizes thumbnail to 124x124
• Creates normal size 600x480
• Sets cantidad_existente equal to cantidad
• Initializes prod_vendidos to 0

---

​

edit($id)

Edit a gallery item.

---

​

delete($id)

Delete a gallery item.

---

​

activa($id)

Publish a gallery item (publicar = 1).

---

​

desactiva($id)

Unpublish a gallery item (publicar = 0).

---

​

verlocal()

AJAX autocomplete for store search. GET Parameter:

• term: Search term

Returns: JSON array of matching stores

---

​

DenunciasController

Handles customer complaints and claims. Location: app/controllers/denuncias_controller.php

​

Properties

• $name: ‘Denuncias’
• $helpers: [‘Html’, ‘Form’, ‘Javascript’]
• $uses: [‘Denuncia’, ‘Locale’, ‘Gallery’, ‘User’]
• $paginate: Limit 10, ordered by fecha DESC

​

Public Methods

These methods are publicly accessible:

• add, consulta, denunciar, fin_denunciar, denunciar_promo, registro_reclamo, registro_denuncia, detallemensajepromo

​

Methods

​

index()

List all complaints with store filtering.

---

​

denunciar()

Submit a complaint about a product.

---

​

denunciar_promo()

Submit a complaint about a promotion.

---

​

responder_denuncia($id)

View complaint details for responding.

---

​

registro_denuncia()

Submit a response to a complaint. Updates: Sets original complaint status to 1

---

​

delete($id)

Delete a complaint.

---