WP Manifestindependent plugin directory
manifest / events / newton-horarios

Newton Horarios

Plugin WordPress para gestión de horarios docentes de Newton CEU, integrado con Newton OPM

by Newton Centro de Estudios · github.com/davidvillarm/newton-horarios

★ 0stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/davidvillarm/newton-horarios/archive/refs/heads/main.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Readme github.com/davidvillarm/newton-horarios ↗

Plugin de WordPress para el registro y control de horarios de docentes de Newton CEU. Pensado para el usuario compartido de Secretaría Directiva, e integrado con el plugin Newton OPM (newton-conducta): reutiliza sus aulas, materias, cursos y docentes, y usa el llamado de lista como comprobante de la hora de llegada del docente.

Qué hace

  • CRUD de horarios previstos: bloques de un solo día o semanales dentro de un rango de fechas (vigencia), con aula, materia, docente previsto, curso, color y observación.
  • Grilla semanal tipo cartel de avisos, filtrable por aula, con colores por materia.
  • Control de cumplimiento: el botón "Verificar con llamado de lista (OPM)" cruza cada clase prevista con wp_conducta_asistencias (fecha + aula + franja horaria) y calcula:
    • hora de llegada (hora en que el docente tomó lista),
    • minutos de retraso,
    • si el docente que dio la clase coincide con el previsto,
    • estado según la política de tolerancia.
  • Política de tolerancia (configurable): llegada hasta 10 min = puntual; entre 10 y 20 min = tolerancia (admitida hasta 3 veces por mes, la siguiente genera amonestación); más de 20 min = amonestación directa. Las amonestaciones automáticas quedan registradas.
  • Edición manual: Secretaría puede corregir cualquier control (estado, docente real, hora de llegada, observación) y dar o anular amonestaciones manualmente.
  • Exportación a Excel: una hoja por aula con la grilla coloreada (como el cartel de avisos) más una hoja "Detalle" con fecha, aula, materia, docente previsto/real, coincidencia, hora de llegada, retraso y estado.
  • Vista del docente: los usuarios con rol docente ven sus próximas clases.

Instalación

  1. Copiar la carpeta newton-horarios a wp-content/plugins/.

  2. Dentro de la carpeta del plugin, instalar la dependencia de Excel:

    composer install --no-dev

    Si no se puede correr composer en el servidor, el plugin intenta usar el PhpSpreadsheet que ya incluye el plugin Newton OPM (newton-conducta/vendor).

  3. Activar el plugin en WordPress. Al activarse crea las tablas wp_horarios_bloques, wp_horarios_control, wp_horarios_amonestaciones y el rol Secretaría Directiva (secretaria_directiva).

  4. Crear una página con slug horarios y el shortcode:

    [newton_horarios_app]

  5. Asignar el rol Secretaría Directiva al usuario compartido de secretaría.

Permisos

Rol Acceso
secretaria_directiva, direccion, funcionarios_administrativos, administrator Gestión completa: horarios, control, amonestaciones, configuración, export
docente Solo lectura de sus propios horarios

API REST (namespace horarios/v1)

  • GET /catalogos — aulas, materias, cursos, docentes y configuración.
  • GET /bloques?desde&hasta[&aula_id][&docente_id] — ocurrencias expandidas con su control.
  • POST /bloques · PUT /bloques/{id} · DELETE /bloques/{id}
  • POST /control/verificar {fecha} o {desde, hasta} — cruce con el OPM.
  • PUT /control/{bloque_id}/{fecha} — corrección manual.
  • GET|POST /amonestaciones · DELETE /amonestaciones/{id}
  • GET|PUT /config — política de tolerancia.
  • GET /export?desde&hasta[&aula_id] — descarga el .xlsx.

Tablas

  • wp_horarios_bloques: horario previsto. tipo='unico' usa fecha; tipo='semanal' usa dia_semana (1=lunes..7=domingo) y se repite entre vigencia_desde y vigencia_hasta.
  • wp_horarios_control: una fila por clase controlada (bloque_id + fecha), con docente previsto/real, hora de llegada, minutos de retraso, estado y fuente (opm/manual). Los controles con fuente manual no se pisan al re-verificar.
  • wp_horarios_amonestaciones: amonestaciones automáticas (origen='auto', vinculadas al control) y manuales, anulables (soft delete con activo=0).