Frontend Submissions possui uma série de recursos que podem ser usados programaticamente.
Transformar um Usuário em um Vendedor
Frontend Submissions possui uma função auxiliar chamada make_user_vendor() que faz duas coisas de uma vez:
- transforma um usuário em um vendedor
- altera o status desse novo vendedor para Aprovado
EDD_FES()->vendors->make_user_vendor( $user_id );
Importante: o parâmetro ID usado acima é o ID do usuário do WordPress.
Alterar o Status de um Vendedor
Existem três status que um Vendedor pode ter:
- Aprovado
- Pendente
- Suspenso
Existem também duas ações que podem ser tomadas:
- Reativar
- Revogar
Todos esses usam o mesmo método, mas status e ações são coisas diferentes. Veja como funciona.
Primeiro, você deve instanciar um objeto Frontend Submissions como um destes:
// Example showing required input $vendor = new FES_Vendor( $_id_or_email = false, $by_user_id = false );
// using a vendor ID $vendor = new FES_Vendor( 14, false ); // using the email address associated with the vendor ID $vendor = new FES_Vendor( '[email protected]', true );
Em segundo lugar, você executa o método change_status() nesse objeto, semelhante a um destes exemplos:
// Example showing required input $vendor->change_status( $new_status = '', $in_admin = false, $output = false );
A entrada $in_admin permite que você declare se esta ação deve ser permitida no contexto da área administrativa ou fora dela. Você pode desejar permitir esta alteração dentro da área administrativa, mas não fora dela, por exemplo.
// Set a vendor to approved, inside the admin area, with no output $vendor->change_status( 'approved' ); // Set a vendor to pending, outside the admin area, with no output $vendor->change_status( 'pending', true ); // Set a vendor to suspended, outside the admin area, with no output $vendor->change_status( 'suspended', true, true );
Além das alterações de status acima, você pode executar estas ações:
// Revoke a vendor, inside the admin area, with no output. // This will effectively make a user NOT a vendor, and remove all their products. $vendor->change_status( 'revoke' ); // Changes a user from suspended to approved. At this point identical to setting // a user to approved, but in the future may contain some additional features. $vendor->change_status( 'unsuspend' );
