geccomedia/weclapp

Accounting made easy for Laravel

Laravel Weclapp

, _(*1)

This repo implements most of the Laravel Eloquent Model for the Weclapp web api., _(*2)

Installation Informations

Require this package with Composer, _(*3)

composer require geccomedia/weclapp

Add the variables to your .env, _(*4)

WECLAPP_BASE_URL=https://#your-sub-domain#.weclapp.com/webapp/api/v1/
WECLAPP_API_KEY=your-key

Usage

Use existing models from "Geccomedia\Weclapp\Models"-Namespace., _(*5)

Most Eloquent methods are implemented within the limitations of the web api., _(*6)

<?php

use Geccomedia\Weclapp\Models\Customer;

class YourClass
{
    public function yourFunction()
    {
        $customer = Customer::where('company', 'Your Company Name')
            ->firstOrFail();

Custom models

Example:, _(*7)

<?php namespace Your\Custom\Namespace;

use Geccomedia\Weclapp\Model;

class CustomModel extends Model
{
    /**
     * The table associated with the model.
     *
     * @var string
     */
    protected $table = 'custom-api-route';
}

Mass assignments

If you want to do mass assignment please use unguard and reguard, _(*8)

Example:, _(*9)

$customer = new \Geccomedia\Weclapp\Models\Customer();
\Geccomedia\Weclapp\Models\Customer::unguard();
$customer->fill(['partyType' => 'ORGANIZATION']);
\Geccomedia\Weclapp\Models\Customer::reguard();

Sub Entities

Weclapp api has some models it views as sub entities to other entities. For those cases we need to supply the main entity for the query with whereEntity($name, $id), _(*10)

Example:, _(*11)

$comments = Comment::whereEntity('customer', 123)->orderByDesc()->get();

Without the call to "whereEntity" the api would complain that we are missing fields. See #22 for more information., _(*12)

Logging

If you want to see the requests being made, you can use the Connections log, _(*13)

Example:, _(*14)

use Geccomedia\Weclapp\Connection;

app(Connection::class)->enableQueryLog();

\Geccomedia\Weclapp\Models\Customer::create(['name' => 'Test'])

app(Connection::class)->getQueryLog();

License & Copyright

Copyright (c) 2017 Gecco Media GmbH, _(*15)

License, _(*16)