Frontend Submissions heeft een aantal functies die programmatisch kunnen worden gebruikt.
Maak een gebruiker een verkoper
Frontend Submissions heeft een hulpfunctie genaamd make_user_vendor() die twee dingen tegelijk doet:
- maakt een gebruiker tot een verkoper
- wijzigt de status van die nieuwe verkoper naar Goedgekeurd
EDD_FES()->vendors->make_user_vendor( $user_id );
Belangrijk: de ID-parameter die hierboven wordt gebruikt, is de WordPress-gebruikers-ID.
Wijzig de status van een verkoper
Er zijn drie statussen die een verkoper kan hebben:
- Goedgekeurd
- In behandeling
- Geschorst
Er zijn ook twee acties die kunnen worden ondernomen:
- Opheffen schorsing
- Intrekken
Al deze gebruiken dezelfde methode, maar statussen en acties zijn verschillende dingen. Hier is hoe het werkt.
Eerst moet u een Frontend Submissions-object instantiëren, zoals een van deze:
// 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 );
Ten tweede voert u de change_status()-methode uit op dat object, vergelijkbaar met een van deze voorbeelden:
// Example showing required input $vendor->change_status( $new_status = '', $in_admin = false, $output = false );
De $in_admin-invoer stelt u in staat om aan te geven of deze actie mag worden toegestaan in de context van het admin-gebied, of daarbuiten. U wilt deze wijziging bijvoorbeeld misschien toestaan binnen het admin-gebied, maar niet daarbuiten.
// 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 );
Naast de bovenstaande statuswijzigingen kunt u de volgende acties uitvoeren:
// 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' );
